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The  documentation  on  the  System  and  Software  Simulator  (S3) 
contained  in  this  and  the  other  three  volumes  is  considered  a  working 
paper  and  no  claims  are  made  as  to  its  accuracy.  There  has  been  no 
attempt  fo  edit  the  information.  Discrepancies  and  inconsistencies 
are  known  to  exist. 

This  information  is  being  released  as  a  service  to  interested  parties 
and  to  sat.Tsfy  the  numerous  requests  for  information  on  S3. 

The  documentation  of  S3  is  contained  in  four  volumes.  Volumes  I 
and  II  are  contract  end  items  delivered  under  contract  number 
DA-49-083  OSA-3306  and  contain  the  technical  descriptions  of  S3. 
Volume  I  describes  the  inputs,  outputs,  methods  and  capabilities 
of  S3.  Volume  II  contains  the  flov/charts,  narrative  description  of  the 
flowcharts,  layouts  and  descriptions  of  the  tables  utilized  by  S3. 

Volumes  III  and  IV  contain  the  documentation  delivered  as  contract 
end  items  under  contract  number  DAAB09-68-C -0 1 18.  Volume  III 
contains  descriptions  of  the  assembly  language  used  for  preparation  of 
input  to  S3,  of  the  macro  capability  of  the  assembler,  and  of  the 
modifications  made  to  S3  to  provide  additional  output  data.  Volume  IV 
in  xhe  program  documentation  on  the  internal  workings  of  the  assembler. 
It  consists  of  table  descriptlont,  flow  charts  and  narratives,  and  file 
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MAIN  PROGRAM 


The  MAIN  prograjn  receives  control  after  S3  is 
loaded  into  memory,  MAIN  then  calls  SMI  which  initializes 
all  of  the  tables  in  common.  When  SMI  is  complete,  it 
returns  control  to  MAIN.  MAIN  then  calls  SM2  which 
executes  the  simulation  model.  When  all  statistic 
intervals  have  been  completed,  SM2  returns  control  to 
Main,  main  then  calls  the  two  final  statistic  subroutines 
STATl  and  STAT.  Upon  completion  of  STAT  the  simulation 


is  terminated. 


SUBROUTINE  SMI 


SMI  recpives  control  from  MAIN.  It  begins  by 
calling  the  card  read  routine  C1-C34.  These  routines  read 
the  card  type  identified  by  the  number  after  the  "C''. 

Each  of  these  "C"  routines  places  the  data  read  into  the 
appropriate  table  in  common. 

Once  all  of  the  hardware  definition,  configura¬ 
tion,  and  system  parameter  cards  have  been  read,  SMI 
reads  the  worker  routine  cards,  card  type  80,  and  stores 
the  information  into  the  worker  routine  base  table,  file 
vector  table,  and  the  statement  table.  In  addition,  for 
each  operating  system  worker  routine  received,  the  inter¬ 
rupt  vector  in  the  appropriate  CPU  item  table  is  filled 
in . 

If  any  errors  in  the  worker  routines  are  detected, 
the  run  is  terminated  without  returning  control  to  MAIN. 

If  no  errors  are  detected,  control  is  returned  to  MAIN. 


Subroutine  ZERO 


The  ZERO  Subroutine  is  used  to  initialize 
all  of  the  tables  for  the  simulator.  The  future 
events  chain  table  is  initialized  to  all  zeroes. 

The  CPU  item  table  is  initialized  to  all  zeroes. 

The  first  word  in  each  entry  in  the  transaction  item 
table  is  initialized  to  minus  1.  All  other  words  in 
each  entry  in  the  transaction  item  table  are  initialized 
to  zero.  The  first  word  for  each  entry  in  the  10 
transaction  item  table  is  initialized  to  minus  1. 

The  remainder  of  each  entry  is  initialized  to  zero. 

The  worker  routine  base  table  is  initialized  to  all 
zeroes.  The  memory  table  is  initialized  to  all  zeroes. 
The  page  table  is  initialized  to  all  zeroes.  The  load 
class  table  is  initialized  to  all  zeroes.  The  run 
class  table  is  initialized  to  all  zeroes.  The  queue 
table  is  initialized  to  all  zeroes.  .The  queue  entry 
table  is  initialized  to  all  zeroes.  The  file  sot  table 
is  initialized  to  all  zeroes.  The  device  set  table  is 
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initialized 

to 

all 

zeroes . 

The 

availability 

table 

is 

initialized 

to 

all 

zeroes . 

The 

channel  table 

is 

initialized 

to 

all 

zeroes . 

The 

control  unit 

table 

is 

initialized 

to 

arl 

zeroes . 

The 

device  class 

table 

is 

initialized 

to 

all 

zeroes . 

The 

general  simulation 

table  is  first  initialized  to  all  zeroes.  Within  the 
general  simulation  table  the  Poisson  Distribution 
table  is  initialized  to  the  values  described  in  the 
coding  for  the  zero  subroutine.  In  addition,  the  size 
of  each  table  used  in  the  simulator  is  entered  into 
the  general  simulation  table.  The  function  table  is 
initialized  to  all  zeroes.  The  statement  is  initialized 
to  all  zeroes.  Each  entry  in  the  switch  table  is 
initialized  to  minus  1.  The  to-from  table  is  initialized 
to  all  zeroes.  The  mark  time  table  is  initialized  to 
all  zeroes.  A  RETURk'  is  then  executed  transfer '’ing 
control  back  to  the  calling  subroutine. 
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Subroutines  Cl  to  C35 


Subroutines  Cl  to  C?5  are  used  to  read  card 
types  one  to  35  into  the  simulator  and  to  build  the 
appropriate  tables. 

Since  each  of  these  subroutines  lullow  the 
same  logic  pattern  a  single  description  will  be  given 
for  all  of  them. 

Each  of  these  subroutines  is  called  in 
segut’nce  by  SMI.  The  subroutine  then  reads  one  record 
from  the  input  file.  If  the  card  type  for  the  record 
read  docs  not  agree  with  the  card  type  expected  by  the 
current  subroutine  and  the  expected  card  type  is 
required,  a  diagnostic  message  is  issued  and  the 
simulation  terminated.  If  the  card  type  for  the  record 
read  does  not  agree  with  the  card  typo  expected  but 
the  cxjjccted  card  typo  is  not  required  by  the  simulator, 
the  input  file  is  BACKSPACED  and  a  RETURN  is  executed 
transfoxring  control  back  to  SMI  wliich  will  then  call 
the  next  READ  routine. 
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If  the  record  read  does  contain  the  card  type 
expected  by  the  current  subroutine  error  checking  is 
performed  and  the  data  is  moved  into  the  appropriate 
table.  Once  a  card  type  which  cannot  be  processed 
by  the  current  RE/\D  routine  is  encountered  the  input 
file  is  BACKSPACED  and  a  RETURN  is  executed,  trans¬ 
ferring  control  back  to  SMI. 
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SUBROUTINE  SM2 


When  SM2  receives  control  from  MAIN,  after  SMI 
has  been  executed,  it  sets  the  current  CPU  number  to  1, 
and  gees  to  the  Cycle  Handling  subroutine.  The  cycle 
handler  will  remove  the  item  at  the  top  of  the  future 
events  chain  aid  begin  the  simulation  run. 

Once  the  simulation  has  begun,  SM2  acts  like  a 
hardware  CPU  timing  loop.  As  each  statement  accessed  by 
SM2  is  executed,  control  passes  to  the  top  of  the  SM2 
loop.  The  loop  consists  of  the  following  operations: 

1)  Test  for  error  detected  in  the  last 
statement . 

2)  Test  for  statistic  time. 

3)  Access  next  instruction  code  (from  NSI 
of  COT ) . 

4)  Test  for  valid  instruction  code. 

5)  Access  all  operands. 

6)  Go  to  statement  calling  sequence. 

Each  statement  vvliich  can  be  executed  by  the 
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simulator  has  a  calling  sequence  in  SM2 .  For  a  simple 
statement  which  does  not  generate  an  interrupt,  or  involve 
the  future  events  chain,  the  calling  sequence  consists  of 
a  call  to  the  "S"  routine,  which  is  numbered  with  the 
statement  number  to  be  executed.  Following  this  call,  is 
a  transfer  to  the  top  of  the  SM2  loop.  This  transfer 
will  be  executed  upon  return  from  the  "S"  subroutine. 

Statements  which  do  generate  an  interrupt  cr 
require  access  to  the  future  events  chain  will  have  a 
call  to  a  "S"  subroutine  in  order  to  handle  the  operation 
code,  followed  by  one  or  more  calls  to  second  level  sub¬ 
routines  numbered  SIXX.  The  SIXX  subroutines  will  handle 
the  interrupt  manipulation  or  accessing  of  the  future 
events  chain.  Every  statement  calling  sequence  is  ended 
by  a  transfer  to  the  top  of  the  SM2  loop. 
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SUBROUTINE  STl  QUEUE  STATISTICS 

The  QUEUE  STATISTICS  subroutine  examines  the 
queue  statistic  switch  in  the  general  simulation  table. 

IT  the  switch  is  set  off,  a  RETURN  is  executed  immediately, 
transferring  control  back  to  the  calling  subroutine.  If 
the  queue  statistics  are  to  be  printed,  a  page  title  and 
line  title  are  printed  immediately - 

For  each  queue  utilized  by  the  current  sim¬ 
ulation,  the  queue  load  statistic  is  nov/  closed  out. 

This  operation  consists  of  subtracting  the  last  queue 
reference  time  from  the  current  simulator  time  and 
multiplying  the  result  by  the  current  number  of  entries 
in  the  queue.  This  value  is  then  added  to  the  total 
queue  load  and  the  last  reference  time  is  set  equal  to 
the  current  simulator  time.  Since  the  queue  load  field 
has  a  value  in  entry  microseconds,  the  average  number 
of  entries  is  obtained  by  dividing  the  queue  load  bv  the 
current  simulator  time.  Tne  number  of  entries  allowed 
in  a  queue  is  determined  by  subtracting  f?  first  entry 
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address  from  the  last  entry  address  and  adding  one. 

The  percentage  utilization  of  a  queue  is  determined 
by  dividing  the  average  number  of  entries  by  the  maximum 
number  of  entries  and  converting  this  to  a  percentage. 
The  average  wait  time  on  a  queue  is  calculated  by 
dividing  the  queue  load  by  the  number  of  items  placed 
on  the  queue . 

These  calculations  are  performed  for  each 
queue  which  has  been  utilized  in  the  current  simulation. 
When  all  queue  statistics  have  been  printed,  a  RETURN 
is  executed,  transferring  control  back  to  the  calling 
subroutine. 


-10- 


SUBROUTINE  ST2  MEMORY  STATISTICS 


The  MEMORY  STATISTICS  subroutine  accesses  the 
memory  statistic  switch  in  the  general  simulation  table 
If  this  switch  is  off,  a  RETURN  is  executed  immediately 
transferring  control  back  to  the  calling  subroutine. 

If  memory  statistics  are  to  be  printed,  the  page  title 
and  line  heading  are  printed  immediately.  A  line  of 
statistics  is  then  printed  for  each  memory  used  in  the 
current  simulation. 

Before  printing  statistics  for  any  memory, 
the  memory  load  is  first  closed  out.  The  memory  load 
is  closed  out  by  subtracting  the  last  memory  reference 
time  from  the  current  simulator  time,  and  multiplying 
this  difference  by  the  current  number  of  pages  busy. 
This  value  is  then  added  to  the  previous  value  of  the 
memory  load  to  come  up  with  the  total  memory  load. 

At  this  point,  the  last  memory  reference  time  is  reset 
to  the  current  simulator  time.  The  memory  load  field 
contains  a  value  in  pane  microsi'cends .  Therefore,  the 
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average  number  of  pages  busy  is  calculated  by  dividing 
the  memory  load  by  the  current  simulator  time.  The 
total  number  of  pages  in  any  given  memory  is  calculated 
by  subtracting  the  low  page  entry  address  from  the  high 
page  entry  address  and  adding  1.  The  percentage  of 
utilization  for  a  given  memory  is  calculated  by  dividing 
the  average  number  of  pages  busy  by  the  total  number 
of  pages  in  the  memory  and  converting  this  to  a  percent¬ 
age  . 

When  the  memory  statistics  have  been  printed 
out  for  every  memory  utilized  in  a  given  simulation, 
a  RETURN  is  executed,  transferring  control  back  to  the 


calling  subroutine. 


SUBROUTINE  ST3  FILE  STATISTICS 


The  FILE  STATISTICS  subroutine  exaunines  the 
file  statistics  switch  in  the  general  simulation  table. 

If  this  switch  is  off,  a  RETURN  is  executed  immediately. 
If  file  statistics  are  to  be  printed,  a  page  heading 
and  line  heading  are  printed  immediately.  For  each 
file  utilized  in  the  current  simulation,  a  lino  of 
statistics  is  printed. 

If  a  file  for  which  statistics  are  to  be 
printed  is  currently  seized,  the  total  seized  tim^.  field 
is  now  closed  out.  This  operation  is  performed  by 
subtracting  the  seized  start  time  from  the  current 
simulator  time  and  adding  this  to  xhe  total  time  seized. 
When  this  has  beer,  performed,  the  seized  start  time  is 
set  equal  to  the  current  simul  Uor  time. 

The  following  conversions  arc  pci  ormcd,  before 
piin.ling  out  statistics  for  a  single  file:  the  seized 
time  is  ciui verted  to  minutes;  the  percentage  seized 
time  is  calculated  by  divlditig  tlie  amount  of  time  the 


file  would  seize  by  the  current  time  and  multiplying 
the  result  by  100;  the  read/write  time  is  converted 
to  minutes,  the  percentage  read/write  time  is  calculated 
by  dividing  the  read/write  time  by  the  current  simulator 
time  and  multiplying  the  result  by  100,  tne  percentage 
of  seize  time  used  is  calculated  by  dividing  the  total 
read/write  time  by  the  total  time  the  file  was  seized 
and  multiplying  the  result  by  100.  Once  statistics 
have  been  printed  out  for  each  file  utilized  in  this 
simulation,  a  RETURN  is  executed,  transferring  control 
back  to  the  calling  subroutine. 


SUBROUTINE  ST4  DEVICE  STATISTICS 


The  DEVICE  STATISTICS  subroutine  tests  the 
device  statistics  switch  in  the  general  simulation 
table.  If  the  switch  is  off,  a  RETURN  is  executed 
immediately.  If  device  statistics  are  to  be  printed, 
the  page  heading  and  line  heading  are  printed  out 
immediately.  There  is  one  line  of  device  statistics 
printed  for  each  device  which  has  been  utilized  durieg 
the  current  simulation. 

Before  printing  out  a  line  of  device  statistics 
the  following  calculations  are  performed:  the  seek  time 
is  converted  to  minutes;  the  percentage  seek  time  is 
calculated  by  dividing  the  total  seek  time 'by  current 
simulator  time  and  multiplying  the  result  by  100;  the 
penalty  time  is  converted  to  minutes;  the  percentage 
penalty  time  is  calculated  by  dividing  ■•he  total  penalty 
time  by  the  current  simulator  time  anfi  multiplying  the 
result  b>  iOdi;  tie  total  dc-vic*'  u'^c  time  is  converted  to 
minutes;  the  percen'iuge  use  time  is  calculated  by  dividin 
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the  total  use  time  by  the  current  simulator  time  and 
multiplying  the  result  by  100;  the  percentage  of  use  time 
spent  seeking  on  this  device  is  calculated  by  dividing 
the  total  time  seeking  by  the  use  time  and  multiplying 
the  result  by  100;  the  percentage  of  use  time  spent 
performing  penalty  operations  for  this  device  is 
calculated  by  dividing  the  total  penalty  time  by  the 
total  use  time  and  multiplying  the  results  by  100. 

Wtien  the  statistics  have  been  printed  out  for  each 
device  utiliJied  during  this  simulation,  a  RETURN  is 
executed  and  control  is  transferied  back  to  the  calling 
subroutine. 
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SUBROUTINE  STS  CONTROL  UNIT  STATISTICS 


The  CONTROL  UNIT  STATISTICS  subroutine 
accesses  the  control  unit  statistics  switch  in  tlie 
general  simulation  table.  If  this  switch  is  off  a 
RETURN  is  executed  immediately,  transferring  control 
back  to  the  calling  subroutine.  If  control  unit 
statistics  are  to  be  printed,  the  page  heading  and  line 
heading  are  printed  immediately.  There  is  one  line 
of  statistics  printed  for  each  control  unit  utilized 
during  the  current  simulation. 

Before  a  line  of  control  uni  x  '■'■atistics  are 
printed,  the  percentage  utilization  is  calculated  by 
dividing  the  totail  time  used  by  the  current  simulator 
time  and  multiplying  the  result  by  100.  In  addition, 
the  total  time  used  by  this  control  unit  is  converted 
to  minutes  from  mici '^seconds .  Once  statistics  have 
been  printed  out  for  each  control  unit  utilized  in 
current  simulation  a  Rl'Tl'RN  is  exoci:ted,  transferring 
control  back  to  the  calling  subroutine. 


SUBROUTINE  ST6  CHANNEL  STATIS'TICS 


The  CHANNEL  STATISTICS  subrt/Utine  examines 
the  channel  statistics  switch  in  the  general  simulation 
table.  If  the  channel  statistics  s.jitch  is  off,  a 
return  is  executed  immediately,  transferring  control 
back  to  the  calling  subroutine.  If  channel  statistics 
are  to  be  printed,  the  page  and  line  headings  are  printed 
immediately.  There  is  one  line  of  channel  statistics 
printed  for  each  channel  utilized  in  the  current 
simulation. 

A  single  channel  in  the  channel  table  may 
consist  of  1  or  2  entries.  A  selector  channel  utilizes 
a  single  entry  and  a  multiplexor  channel  utilizes  two 
entries.  For  a  multiplexor  channel,  the  first  entry 
contains  statistics  on  the  multiplexor  channel's  use 
in  burst  mode.  The  second  entry  contains  information 
for  the  channel's  use  in  multiplexor  mode .  The  following 
statistics  are  calculated  before  pr-nting  each  line  of 
channel  statistics:  the  selector  use  time  is  converted 


to  minutes;  the  percentage  of  the  available  time  used 
by  a  selector  channel  or  by  a  multiplexor  channel  in 
burst  mode  is  calculated  by  dividing  the  total  time 
used  by  the  current  simulator  time;  the  percentage  of 
selector  or  burst  mode  utilization  is  calculated  by 
dividing  the  number  of  characters  transmitted  by  the 
total  number  of  characters  which  could  have  been  trans¬ 
mitted.  If  the  channel  for  which  statistics  are  being 
printed  is  a  selector  channel,  the  multiplexor  channel 
statistics  are  set  equal  to  zero  and  the  percentage 
total  utilization  is  set  equal  to  the  percentage  selector 
utilization.  For  a  multiplexor  channel,  the  percentage 
multiplexor  utilization  is  calculated  by  dividing  the 
total  number  of  characters  transmitted  by  the  total 
number  of  characters  which  could  have  been  tran'mitted 
utilizing  the  maximum  multiplexor  transfer  rate.  The 
total  percentage  utilization  for  this  channel  is  then 
calculated  by  adding  the  percentage  burst  mode  utilization 
to  the  percentage  multiplexor  utilization.  Once  statist  ice 
have  been  printed  for  cacli  clKuinel  utilized  during  the 
current  simulation,  a  Rli  TURN  is  executed  t  r  an  s  fe  r  r  i  ng 
control  b ‘.ck  to  th*.’  cal  lino  sub  mat  t  i  tu' . 
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SUBROUTINE  ST7  CPU  STATISTICS 


The  CPU  STATISTICS  subroutine  examines  the 
CPU's  statistics  switch  in  the  general  simulation  table. 
If  the  CPU  statistics  switch  is  off,  a  RETURN  is  executed 
immediately,  transferring  control  back  to  the  calling 
subroutine.  If  CPU  statistics  are  to  be  printed,  the 
page  and  line  headings  are  printed  immediately.  A 
single  line  of  CPU's  statistics  are  printed  for  each 
CPU  utilized  during  the  current  simulation. 

Before  a  line  of  statistics  is  printed,  the 
following  calculations  are  performed;  the  operating 
system  transaction  item  queue  time,  the  operating 
system  10  transaction  queue  time,  the  CPU  cycle  time 
and  the  operating  system  time  are  all  converted  to 
minutes;  the  total  amount  of  CPU  time  available  for 
worker  routine  transaction  items  is  calculated  by 
subtracting  the  total  cycle  time  plus  tb.e  tota' 
operating  system  time  for  the  currem  CPU  from  the 
current  simulator  time  and  tlien  convc'rtind  the  result 
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to  minutes;  the  percentage  utilization  for  a  CPU  is 
calculated  by  dividing  the  total  time  available  for 
worker  routines  by  the  current  simulator  time  and 
multiplying  the  result  by  100. 

It  should  be  noted  here  that  there  may  be 
a  slight  inaccuracy  in  the  total  amount  of  time 
allocated  to  worker  routine  transaction  items.  Under 
normal  circumstances  where  the  simulator  time  at  the 
end  of  a  statistics  interval  is  very  large  compared  to 
a  single  operating  system  transaction  item’s  time, 
the  fact  that  there  may  be  one  or  more  operating  system 
transactions  still  in  the  system,  whose  total  CPU  time 
has  not  yet  been  accounted  for,  should  make  little 
difference  to  the  statistics. 

After  a  line  of  statistics  has  been  printed 
out  for  eacli  CPU  utilized  during  the  current  simulation, 
a  summary  line  is  printed.  The  summary  line  contains 
the  averages  from  each  of  the  detail  lines.  Once  the 
summary  lii'.e  has  been  print('d,  a  return  is  executed  and 
control  is  t  ransi'cu'red  t)ack  to  tho  callin'^!  subroutine. 
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SUBROUTINE  ST8  QUEUE  TRANSACTION  ANALYSIS 


The  QUEUE  TRANSACTION  ANALYSIS  subroutine 
examines  the  queue  transaction  analysis  switch  in  the 
general  simulation  table.  If  the  switch  is  off,  a 
return  is  executed  immediately  transferring  control  back 
to  the  calling  subroutine. 

If  a  queue  transaction  analysis  is  to  be 
performed,  the  queue  transaction  file  FORTRAN  unit 
number  18  is  rewound.  During  this  rewind  operation, 
the  queue  analysis  table  and  the  10  table  are  zeroed. 

The  queue  transaction  file  is  roac’  once  for  each  queue 
used  during  the  current  simulation.  For  each  of  these 
queues  page  and  line  headings  are  printed. 

The  queue  trans-CvCtion  file  consists  of  blocks 
of  100  records,  whore  each  record  contains  the  information 
about  a  single  transaction's  stay  on  some  queu?.  A, 
xacord  is  createil  each  timv’  a  select  statement  is  executed 
by  any  opc-ratiss^  system.  As  th.e  qiuniv.'  transaction  file  is 
read  fc)r  e.vch  queue,  an  accumul  a  t  i  cm  tif  the  liuration  c'f 


of  time  spent  by  tran'-action  items  and  10  transaction 
items  for  a  single  worker  routine  is  accumulated. 

The  items  accumulated  are  only  for  the  queue  currently 
being  analyzed. 

Once  an  end  of  file  has  been  reached,  all 
the  entries  in  the  analysis  table  are  converted  to 
seconds  and  a  table  is  printed  out  for  a  single  queue. 
This  table  will  contain  one  lino  for  each  worker 
routine  which  had  a  transaction  or  10  transaction  on 
the  current  queue  being  examined.  After  all  of  the 
queues  have  been  analyzed,  a  RETURN  is  executed  and 
control  is  transferred  bach  •'■o  the  calling  subroutine. 


SUBROUTINE  STAX  WORKER  ROUTINE  STATISTICS 


Tl-is  WORKER  ROUTINE  STATISTIC  subroutine  first 

initiali;ies  the  worker  routine  statistics  table.  The 

worker  routine  statistics  table  is  designed  to  contain 

minimum  average  and  maximum  values  for  all  of  the 

information  about  any  worker  routine  in  the  system. 

The  worker  routine  transaction  termination  file  is 

written  each  time  a  transaction  item  is  destroyed. 

The  STAT  subroutine  reads  back  this  file  in  the  same 

order  in  which  it  was  created  and  prints  out  a  trans- 

* 

action  termination  list. 

The  transaction  termination  list  consists  of' 
the  following  information:  the  statistical ' interval 
during  which  this  transaction  item  was  destroyed, 
(statistic  intervals  are  numbered  starting  with  7,ero); 
the  transaction  item  identification  number,  conpisting 
of  the  worker  routine  number  plus  a  .four  digit  trans¬ 
action  item  sequence  number;  the  time  at  which  this 
transaction  item  was  destroyed;  the  time  that  the 
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transaction  was  created;  the  total  amount  of  CPU  time 
utilized  by  this  transaction;  the  total  amount  of  time 
transaction  items  spent  on  queues;  and  the  total  eonount 
of  time  which  10  transaction  items  generated  by  this 
transaction  spent  on  queues.  In  addition,  there  is  a 
record  of  the  total  number  of  OP  operations  performed 
on  up  to  20  files  for  each  transaction. 

As  the  information  from  each  transaction 
item  termination  is  printed  out,  it  is  also  accumulated 
into  the  worker  routines  statistics  table.  Once  all 
transaction  terminations  have  been  printed,  the  worker 
routine  statistic  table  is  analyzed.  There  is  one 
page  of  worker  routine  statistics  printed  for  each 
worker  routine  which  had  a  transaction  terminate  during 
the  course  of  this  simulation.  The  following  statistics 
are  printed  from  the  worker  routine  statistics  table: 
the  number  of  transactions  generated  and  the  number 
of  transactions  called;  the  minii’m,  average,  and 
maximum  for  each  of  the  following  values  -  turnaround 
time,  CF'U  time,  transaction  item  queue  time,  10  trans¬ 
action  item  queue  time.  In  addition,  the  minimum 
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average  and  maximum  number  of  10  operations  on  each  of 
the  20  files  available  to  a  worker  routine  are  also 
printed.  After  all  of  the  worker  routine  statistics 
have  been  printed,  the  message  -'END  OK  SIMULATION" 
is  pat  out  on  the  print  file  and  the  EXIT  routine  is 
called,  terminating  the  simulation. 


I 

I 

I 

II  Subroutine  TDUMP 

1^  The  TDIIMP  subroutine  calls  each  of  the 

I  individual  table  dump  subroutines  and  then  returns 

control  to  the  calling  subroutine. 
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Subroutine  SNAP 


The  SNAP  subroutine  first  examines  the  SNAP 
subroutine  control  switch  in  the  general  simulation 
table.  If  this  switch  is  off,  a  RETURN  is  executed 
immediately  and  control  is  transferred  back  to  the 
calling  subroutine. 

If  the  SNAP  control  switch  is  on  the  SNAP 
counter  in  the  general  simulation  table  is  incremented 
by  one  and  a  print  out  of  the  current  simulator 
status  is  provided.  The  printout  provided  contains 
information  about  the  current  CPU  number,  the  current 
operating  transaction,  the  current  available  trans¬ 
action,  and  the  current  10  transaction  item.  Once 
this  printout  has  been  provided,  a  RETURN  is  executed 
transferring  control  back  to- the  calling  subroutine. 
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Subroutine  S951 


Subroutine  S951  first  tests  to  determine  if 
there  is  a  valid  current  operating  CPU.  If  no  valid 
current  operating  CPU  exists,  a  RETURN  is  executed 
immediately  transferring  control  back  to  the  calling 
subroutine.  If  a  valid  current  operating  CPU  exists, 
the  S951  subroutine  next  tests  the  trace  control 
switch  in  the  general  simulation  table.  If  the  trace 
control  switch  is  off,  a  RETURN  is  executed  immediately 
transferring  control  back  to  the  calling  subroutine. 

If  the  trace  control  switch  is  on,  a  line  of  print  is 
generated  providing  the  current  status  within  the 
■simulator. 

The  information  provided  by  subroutine  S951 
consists  of  the  following  items; 

1.  The  current  operating  CPU  number. 

2.  The  current  operating  transaction  number. 

> 

3.  The  current  available  transaction  number. 

4.  The  current  10  transaction  item  number. 


-29- 


5.  The  current  operation  code. 

6.  The  first  operand. 

7.  The  second  operand. 

8.  The  third  operand. 

9.  The  fourth  operand. 

10.  The  current  simulator  time 

11.  The  current  future  events  chain  code. 

12.  The  current  future  events  chain  item. 

13.  The  current  subroutine  number. 

14.  The  current  interrupt  number. 

15.  The  next  sequential  instruction  for  the  COT. 

16.  The  next  sequential  instruction  for  the  AT. 

17.  The  next  sequential  instruction  code  from 
the  general  simulation  table. 

18.  The  current  errer  code. 

19.  The  current  program  number. 

20.  The  current  random  number. 

Once  the  above  information  has  been  generated 
a  REl'URN  instruction  is  executed  transferring  control 
back  tc  the  calling  subroutine. 


Subroutine  POIS 


The  F*OIS  subroutine  first  calls  the  random 
number  generator.  Upon  return  of  control  from  the 
random  number  generator  the  random  amber  will  be 
found  in  the  general  simulation  table.  The  range  of 
the  random  number  found  will  be  from  0  to  99.  The 
random  number  provided  is  then  rounded  down  to  the 
nearest  multiple  of  5  and  then  divided  by  5.  The 
number  thus  obtained  is  then  added  to  the  value  81 
and  an  entry  is  extracted  from  the  Poisson  Distribution 
function  found  in  the  general  simulation  table.  The 
value  obtained  from  the  Poisson  Distribution  table  is  • 
then  multiplied  by  the  value  supplied  upon  entry  to 
the  POIS  subroutine.  The  result  of  this  multiplication 
is  then  placed  in  the  output  parameter  and  a  RETURN  is 
executed,  transferring  control  back  to  the  calling 
subroutine.  . 
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Subroutines  DTI  to  DT25 


Subroutines  DTI  to  DT25  are  used  to  provide 
a  printout  of  each  of  the  tables  from  table  1  to 
table  25. 

Since  each  of  these  subroutines  follow  the 
same  logic  pattern  a  single  description  will  be  given 
for  all  of  them. 

Each  of  these  subroutines  is  called  in 
sequence  by  TDUMP.  The  subroutine  then  testJ  a 
switch  to  determine  if  the  user  has  indicated  the 
current  table  printout  is  not  of  interest.  If  the 
switch  is  on  a  RETURN  is  executed  transferring  control 
back  to  TDUMP.  If  the  switch  if  off  indicating  the 
user  does  want  the  printout  of  the  current  table  the 
DR  subroutine  provides  that  printout  from  the  inform¬ 
ation  currently  in  the  table  by  mcar s  of  a  FORMAT 
statement.  In  general,  the  DT  subroutine  does  not  print 
all  possible  entries  from  a  table,  but  rather  stops 
printing  when  there  are  no  more  entries  in  the  table 
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being  used  by  the  current  simulation.  Once  all  possible 


entries  for 
is  executed 


a  given  table  have  been  printed  a  RETURN 
transferring  control  back  to  TDUMP. 
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SUBROUTINE  SI  TRANSFER 


The  TRANSFER  subroutine  picks  up  the  current 
operating  CPU  from  the  general  simulation  table.  It 
then  accesses  the  current  operating  transaction  for  that 
CPU.  The  next  sequential  instruction  is  then  replaced 
in  the  current  operating  transaction  with  the  new  trans¬ 
fer  address.  Upon  completion  of  this  operation  control 
is  returned  to  SM2 . 
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SUBHOUTINb  S2  TRANSFER  ON  PROBABILITY 


The  TRANSFER  ON  PROBABILITY  subroutine  calls 
the  random  nu'-ber  generator,  which  will  return  a  number 
within  the  range  from  0  to  99.  It  the  random  number 
generated  is  less  than  the  percentage  probability  for 
transferring,  control  is  passed  to  the  transfer  sub¬ 
routine  which  will  update  the  next  sequential  instruc¬ 
tion  in  the  current  operating  transaction.  If  the 
randem  number  generated  is  equal  to,  or  greater  than  the 

percentage  probability  of  transfer,  control  will  be 

* 

returned  to  SM2  without  altering  the  next  sequential 
instruction. 


SUBROUTINE  S3  READ 


The  READ  subroutine  accesses  the  current 
operating  transaction  within  th  ^  current  operating  CPU. 

The  ordinal  file  number  specified  by  the  READ  statement 
is  then  stored  into  this  transaction  as  the  current  file 
request.  The  ordinal  file  is  stored  as  a  positive  number, 
because  the  10  operation  requested  is  an  input  operation. 
In  addition,  the  interrupt  code  in  the  general  simulation 
table  is  set  to  2,  in  order  to  generate  a  Read/Write 
interrupt.  Control  is  then  returned  to  SM2.  When  SM2 
receives  control  it  will  transfer  control  to  SilO,  the 
Interrupt  Handler. 
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SUBROUTINE  S4  WRITE 


The  WRITE  subroutine  performs  the  exact  same 
functions  as  the  REj^D  subroutine,  with  the  exceptions 
that,  the  current  file  request  is  stored  as  a  negative 
number  in  the  current  operating  transaction,  to  indicate 
that  the  10  operation  requested  is  an  output  operation. 
When  control  is  returned  to  SM2 ,  tne  interrup"*  subroutine 
SllO  will  be  called  just  as  for  the  RE.\D  statement. 
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SUBROUTINE  S5  FUNCTION 

The  FUNCTION  subroutine  accesses  the  current 
operating  transaction  for  the  current  operating  CPU. 

This  transaction  item  address  is  placed  into  the  general 
simulation  table  as  an  input  argument  to  S104,  the 
Generate  10  Transaction  Item  subroutine.  Subroutine 
S104  is  then  called.  When  control  is  returned  to  the 
FUNCTION  subroutine,  the  general  simulation  table  will 
contain  the  address  of  the  10  transaction  item  just 
generated.  The  FUNCTION  subroutine  then  sets  the  10 
transaction  item  type  code  equal  to  5  to  indicate  a 
function  10  transaction,  and  stores  the  Function  Number 
from  the  FUNCTION  statement  into  the  10  transaction. 

The  interrupt  code  in  the  general  simulation  table  is 
then  set  to  3  to  cause  a  function  interrupt  into  the 
operating  system.  The  next  10  transaction  word  in  the 
current  v/porating  CPU  is  then  set  to  the  address  of  the 
10  transaction  item  generated.  Control  is  then  returned 
to  SM2 ,  wh’ch  will  next  call  SllO,  the  Interrupt  Handler. 
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SUBROUTINE  S6  END  OF  KILE 


The  END  OF  FILE  subroutine  accesses  the  current 
operating  transaction  for  the  current  operating  CPU. 

From  part  one  of  this  transaction  the  address  of  the 
worker  routine  base  is  determined.  The  file  vector 
table  is  then  accessed,  using  the  worker  routine  base, 
and  the  ordinal  file  number  specified  in  the  END  OF  FILE 
statement.  The  address  of  the  real  file  associated  with 
this  ordinal  file  is  determined  from  the  fils  vector 
table.  The  total  number  of  10  operations  performed  for 
this  ordinal  file  is  then  determined  by  looking  into  the 
appropriate  entry  of  the  transaction  item  part  two.  If 
the  ordinal  file  number  specified  in  the  END  OF  FILE 
statement  is  greater  than  7,  then  part  two  transaction 
items  may  be  chained  together  eind  it  will  be  necessary 
to  look  down  this  chain  to  find  the  correct  entry. 

If  the  total  number  of  10  operations  performed 
for  this  ordinal  file  is  less  than  the  total  number  of 
blocks  in  this  real  file,  then  a  RETURN  is  executed  with- 
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out  altering  the  next  sequential  instruction.  However, 
if  all  of  the  blocks  in  this  real  file  have  been  read, 
or  written,  the  next  sequential  instruction  is  set  to 
the  transfer  location  specified  in  the  END  OF  FILE  state¬ 
ment.  At  this  point,  a  RETURN  is  executed  returning 
control  to  SM2. 
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SUBROUTINE  S7  SUBROUTINE 


The  SUBROUTINE  subroutine  accesses  the  current 
operating  transaction,  for  the  current  operating  CPU.  It 
then  examines  the  subroutines  next  sequential  instruction 
addresses  in  the  transaction  item  looking  for  an  empty 
space.  If  no  empty  space  can  be  found,  then  an  error 
code  of  1  is  set  and  a  return  to  SM2  is  executed.  This 
error  code  specifies  more  than  three  nested  subroutines 
have  been  attempted.  If  an  empty  slot  has  been  found  in 
one  of  the  three  locations  supplied,  then  the  next  se¬ 
quential  instruction  is  stored  into  this  location.  The 
NSI  in  the  transaction  item  is  then  set  to  the  transfef 
location  specified  by  the  SUBROUTINE  statement,  and  a 
return  is  executed  to  SM2 . 
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SUBROUTINE  S8  EXIT 


The  EXIT  subroutine  accesses  the  current  opera¬ 
ting  transaction  for  the  current  operating  CPU.  It  then 
examines  the  three  subroutines  next  sequential  instruction 
addresses  in  this  transaction  item,  looking  for  a  return 
address.  If  no  return  address  is  found,  the  subroutine 
error  code  is  set  to  1,  and  a  return  to  SMR  is  executed. 
This  error  code  specifies  that  an  EXIT  statement  was 
encountered  without  being  called  by  a  SUBROUTINE  state¬ 
ment,  If  a  return  address  is  found,  the  return  address 
is  set  into  the  next  sequential  instruction  location  and 
the  return  address  location  is  set  to  zero.  When  these 
operations  have  been  completed,  control  is  returned 


SUBROUTINE  S9  LOOP 


The  LOOP  subroutine  accesses  the  current  opera¬ 
ting  transaction  in  the  current  operating  CPU.  It  then 
compares  the  next  sequential  instruction  location  for  this 
transaction  with  the  three  loop  address  locations  in  the 
same  transaction.  If  an  equal  condition  is  encountered, 
this  means  that  the  loop  segment  is  currently  active  and 
that  one  or  more  loops  have  previously  been  executed.  The 
loop  count  associated  with  this  loop  address  is  then 
tested  for  zero  to  determine  if  the  appropriate  number  of 
loops  have  been  completed.  If  the  loop  count  is  zero, 
then  the  loop  address  is  also  set  to  zero,  and  a  return 
is  executed,  transferring  control  to  SM2  without  altering 
the  next  sequential  instruction.  If  the  loop  count  is 
not  ?:ero,  this  means  that  additional  loops  must  be  per¬ 
formed,  therefore,  the  loop  counter  is  decremented  by  1, 
and  the  next  sequential  instruction  is  set  to  the  trans- 
fer  location  specified  by  the  LOOP  statement. 

In  the  case  where  the  loop  is  not  active,  the 
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transaction  item  is  examined  for  an  empty  loop  address 
location.  If  no  empty  loop  address  location  can  be 
found  this  means  that  a  fourth  loop  statement  has  been 
encountered,  without  the  completion  of  any  previous  loop. 
This  is  an  error  condition,  the  error  code  is  set  to  1, 
and  the  return  is  executed,  transferring  control  to  SM2. 
If  an  empty  loop  address  location  can  be  found,  the  next 
sequential  iiistruction  address  is  stored  into  the  loop 
address,  the  next  sequential  location  is  set  to  the 
transfer  location  specified  in  the  loop  statement,  and 
the  loop  count  is  decremented  by  1.  A  return  is  then 
executed,  transferring  control  back  to  SM2 . 
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SUBROUTINE  SIO  MOVE 


The  amount  of  time  required  to  simulate  a  MOVE 
operation  is  calculated  by  dividing  the  number  of 
characters  to  be  moved  by  the  number  of  characters  per 
Logical  Data  Uixit,  in  order  to  determine  the  number 
of  Logical  Data  Units  to  be  moved.  The  number  of  Logical 
Data  Units  is  then  multiplied  by  the  time  to  move  a  single 
Logical  Data  Unit,  and  this  gives  the  time  to  complete 
the  entire  HOVE  operation.  This  time  is  then  stored 
as  the  ADVANCE  TIME  in  the  time  entry  of  the  current 
operating  transaction  for  the  current  operating  CPU.  A 
return  is  then  executed,  transferring  control  back  to 
SM2 .  When  SM2  receives  control,  it  will  call  the  Place 
Transaction  Item  on  the  Future  Events  Chain  subroutine. 
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SUBROUTINE  Sll  MOVE  AND  EDIT 


The  time  required  to  execute  a  MOVE  AND  EDIT 
operation  is  calculated  by  multiplying  the  number  of 
characters  to  be  moved  and  edited  by  the  amount  of  time 
to  move  and  edit  a  single  character  for  the  current 
CPU.  This  time  is  then  stored  in  the  ADVANCE  TIME  entry 
of  the  time  section  of  the  current  operating  transaction. 
A  return  is  then  executed,  transferring  control  back 
to  SM2,  which  will  then  call  the  Place  Transaction  Item 
on  the  Future  Events  Chain  subroutine. 


SUBROUTINE  S12  COMPUTE 


The  time  required  to  simulate  a  COMPUTE  opera¬ 
tion  is  determined  by  multiplying  the  number  of  instruc¬ 
tions  specified  in  the  compute  statement  by  a  factor 
drawn  at  random  from  a  Poisson  distribution,  and  then 
multiplying  the  result  of  this  operation  by  the  Gibson 
Mix  Time,  the  average  time  to  execute  a  single  operation 
in  this  computer.  This  time  is  then  stored  as  ADVANCE 
TIME,  in  the  time  entry  of  the  current  operating  trans¬ 
action,  for  the  current  operating  CPU.  A  return  is  then 
executed,  transferring  control  back  to  SM2,  which  will  then 
call  the  Place  Transaction  Item  on  the  Future  Events  Chain 
subroutine . 
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SUBROUTINE  S13  MATH 


The  MATH  siibroutine  accesses  the  current 
operating  transaction  for  the  current  operating  CPU. 

From  the  current  operating  transaction  it  determines  the 
address  of  the  worker  routine  base.  From  the  worker 
routine  ba~e,  it  accesses  the  program  type.  The  program 
type  is  used  to  determine  which  is  the  preferred 
arithmetic  se  to  be  used  for  this  MATH  statement.  If  the 
program  type  is  commercial,  then  decimal  arithmetic  times 
will  be  used  if  available.  If  decimal  arithmetic  times 
are  not  available,  then  fixed  point,  or  floating  point 
will  be  used  in  that  sequence.  If  the  program  type  is' 
scientific,  then  floating  point  arithmetic  times  will 
be  used  if  available.  If  floating  point  times  are  not 
available,  then  fixed  point,  or  decimal  times  will  be 
used  in  that  sequence. 

The  tot.il  amount  of  time  to  bo  simulated  for 
this  MATH  statement  is  determined  by  multiplyinj  the 
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n'unber  of  add,  multiply  and  divide  operations  times  the 
appropriate  add,  multiply  and  divide  times  for  a  single 
operation,  using  the  correct  type  of  arithmetic  for  the 
current  CPU,  This  time  is  then  stored  in  the  time 
entry  of  the  current  operating  tramsaction  as  the 
ADVANCE  time.  A  RETURN  is  then  executed,  and  control 
is  transferred  t  SM2.  When  SM2  receives  control,  it 
will  call  the  Place  Transaction  Item  on  the  Future  Events 


Chain  subroutine.  If  a  MATH  statement  is  executed  with 
no  decimal,  fixed  point,  or  floating  point  arithmetic 
times  supplied  for  the  current  CPU,  the  error  code  is 
set  to  1,  and  a  RETURN  is  executed,  treuisf erring  control 


back  to  SM2 


SUBROUTINE  S14  OPEN 


The  OPEN  subroutine  accesses  the  current  operating 
transaction  for  the  current  operating  CPU.  It  then  examines 
the  total  number  of  10  operations  performed  for  the  ordinal 
files  specified  in  the  OPEN  statement.  If  the  total  num¬ 
ber  of  10  operations  field  is  negative,  the  file  is  closed. 
If  the  file  is  not  closed,  an  error  condition  exists,  since 
a  worker  routine  is  attempting  to  open  a  file  which  is 
already  open.  The  error  code  is  set  to  101  and  the  error 
handling  subroutine  SlOl  is  called.  Since  the  error  code 
is  greater  than  100,  the  simulation  is  not  terminated, 
but  continues  from  here.  If  the  file  is  closed,  or  after 

•  *  j 

the  error  message  has  been  printed,  the  total  ntimber  of 
10  operations  field  is  set  to  positive,  indicating  the 
file  is  now  open.  Next  the  code  specifying  whether  this 

is  an  OPEN- INPUT,  or  an  OPEN-OUTPUT  operation  is  examined. 

* 

If  this  code  is  invalid,  the  error  code  is  set  to  1  in  the 
general  simulation  table  and  a  return  is  executed  trans-  ■ 
f erring  control  back  to  SM2,  If  this  is  an  OPEN-OUTPUT 


operation,  the  ordinal  file  number  from  the  OPEN  state¬ 
ment  is  set  into  the  current  file  request  as  a  negative, 
number,  indicating  an  output  operation.  If  this  i. 
an  OPEN-INPUr  statement,  then  the  ordinal  file  niimber  from 
the  OPEN  statement  is  stored  into  the  current  file  request 
as  a  positive  number  indicating  an  input  operation.  At 
this  point,  the  generate  10  transaction  item  subroutine 
S104  is  called,  after  the  worker  routine  number  for  this 
transaction  is  set  into  the  general  simulation  table. 

Upon  return  .from  this  subroutine  the  general  simulation 
table  contains  the  address  of  the  generated  10  trans¬ 
action  item.  The  10  transaction  type  is  then  set  to  1 
indicating  an  open  operation.  The  interrupt  code  in  th^ 
general  simulation  table  is  set  to  8  indicating  an  OPEN/ 
CU^SE  interrupt,  and  the  10  transaction  5  tern  address  is 
set  into  the  CPU  item  as  the  next  10  transaction 
At  this  point  a  RETURN  is  executed,  transferring  control 
back  to  SM2,  where  the  Interrupt  Handling  subroutine  SllO 
will  be  called. 
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SUBROUTINE  S15  CLOSE 


The  CLOSE  subroutine  accesses  the  total  number 
of  10  operations  performed  for  the  ordinal  file  specified 
in  the  CLOSE  statement.  It  then  sets  the  total  number 
of  10  operations  performed  negative  to  indicate  that  this 
file  is  closed.  The  ordinal  file  number  from  the  CLOSE 
statement  is  then  stored  into  the  transaction  item  as  the 
current  file  request.  The  generate  10  transaction  item 
subroutine  S104  is  then  called,  after  storing  the  trans¬ 
action  item  number  into  the  general  simulation  table  as 
a  calling  argument.  When  control  is  returned  to  the 
CLOSE  subroutine,  the  address  of  the  generated  10  trans¬ 
action  item  is  found  in  the  general  simulation  table.  The 
CLOSE  subroutine  then  sets  the  10  transaction  type  equal 
to  2  indicating  a  close  operation  and  stores  the  rewind 
code  into  the  10  transaction  item,  specifying  whether  or 
not  the  file  is  to  be  rewound.  The  interrupt  code  in 
the  general  simulation  table  is  then  set  equal  to  8, 
indicating  an  Open/Close  interrupt  is  to  be  genarated  and 
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the  address  of  the  10  transaction  item  is  stored  into 
the  current  CPU  item  as  the  next  10  transaction  item. 

A  RETURN  is  then  executed,  transferring  control  back  to 
SM2.  SM2  will  then  call  subroutine  5110  the  Interrupt 
Handling  subroutine. 
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SUBROUTINE  Si6  TERMINATE 

The  TERMINATE  subroutine  sets  the  interrupt 
code  in  the  general  simulation  table  equal  to  6,  in 
order  to  cause  a  Program  Termination  interrupt,  /r:  the 
TERMINATE  statement  has  a  zero  argument,  indicating  that 
no  program  is  to  be  called  when  this  TERMINATE  statement 
is  executed,  a  RETURN  is  now  executed  and  control  is 
passed  to  SM2.  If  a  program  is  to  be  called  out  when  this 
terminate  is  executed,  a  test  is  made  to  see  that  the  AT 
for  the  current  operating  CPU  is  equal  to  zero.  If  the  AT 
is  not  equal  to  zero,  the  error  code  is  set  equal  to  1 
and  the  RETURN  is  executed,  transferring  control  back  to 
SM2.  If  the  AT  is  equal  to  zero,  S53  the  ACTIVATE  sub¬ 
routine  is  called.  The  ACTIVATE  subroutine  will  generate 
a  transaction  for  the  worker  routine  specified  in  the 
TERMINATE  statement  and  place  the  transaction  word  into 
the  AT  of  the  current  operating  CPU.  The  TERMINATE  sub¬ 
routine  then  passes  the  AT  transaction  word  plus  the 
current  CPU  number  to  subroutine  S201,  which  will  place 
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that  transaction  item  at  the  top  of  the  future  events 
chain.  A  RETURN  is  then  executed  which  will  transfer 
control  back  to  SM2.  When  SM2  gets  control  it  will 
call  subroutine  SllO  the  Interrupt  Handling  Subroutine 
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Subroutine  S17  PRINT 


The  PRINT  subroutine  first  stores  its  subroutine 
number  into  the  general  simulation  table.  The  ordinal 
file  number  for  which  the  current  request  is  to  be 
executed  is  then  accessed  from  the  statement  table. 

This  file  request  is  set  negative  since  the  current 
10  operation  is  an  output  operation.  The  file 
request  thus  obtained  is  stored  into  the  current 
operating  transaction  as  the  current  file  request. 

The  interrupt  code  in  the  general  simulation  table  is 
set  equal  to  2,  and  the  number  of  space  operations 
to  be  performed  after  this  PRINT  is  obtained  from  the 
statement  table  and  stored  Into  the  current  operating 
transaction.  Th»  available  transaction  is  then  set 
equal  to  the  current  operating  transaction,  and  the 
current  operating  transaction  is  set  equal  to  zero. 

A  RETURN  is  then  executed  transferring  control  back 
to  the  calling  subroutine. 
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Sub:«:outine  S18  CALL 


The  CALL  subroutine  first  stores  its  subroutine 
nunber  into  the  general  simulation  table.  The  called 
program  number  is  then  accessed  from  the  statement 
table  and  stored  into  the  current  operating  trans¬ 
action.  If  the  current  operating  transaction  is  to 
he  delayed  while  the  called  program  is  executed  the 
interrupt  number  in  the  general  simulation  table  is 
set  equal  to  9  and  a  RETURN  is  executed  transferring 
control  back  to  the  calling  subroutine.  If  the  current 
operating  transaction  is  not  to  be  delayed  while  the 
called  program  executes,  the  interrupt  number  in  the 
general  s.lmulation  table  is  set  equal  to  10  before  the 
RETURN  is  executed  transferring  control  back  to  the 
calling  subroutine.  If  the  delay  code  in  the  statement 
table  is  in  error  an  error  code  of  1  is  set  and  a 
RETURN  is  executed. 
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Subroutine  S19  EXEC 


The  EXEC  subroutine  stores  its  subroutine 
number  into  the  general  simulation  table.  The  first 
operand  is  then  accessed  from  the  general  simulation 
table  and  stored  as  the  current  interrupt  number  into 
the  general  simulation  table.  A  RETURN  is  then 
executed  transferring  control  back  to  the  calling 


subroutine . 
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Subroutine  S20  LOOP  ON  PROBABILITY 

I  The  LOOP  ON  PROBABILITY  subroutine  accesses 

the  current  operating  transaction  in  the  current 

I 

operating  CPU.  It  then  compares  the  next  sequential 
instruction  location  for  this  transaction  with  the 
three  LOOP  address  locations  in  the  same  transaction. 

If  an  equal  condition  is  encountered,  this  means  that 
the  LOOP  segment  is  currently  active  and  thrt  one  or 
more  loops  have  previously  been  executed.  The  loop 
count  associated  with  this  loop  address  is  then  tested 
for  zero  to  determine  if  the  appropriate  number  of 
loops  have  been  completed.  If  the  loop  count  is  zero, 
then  the  loop  address  is  also  set  to  zero,  and  a  RETURN 
is  executed,  transferring  control  to  SM2  without 
altering  the  next  sequential  instruction.  If  the  loop 
count  is  not  zero,  this  means  that  additional  loops 
may  be  performed,  therefore,  the  loop  counter  is 
decremented  by  oi'.e.  A  call  is  then  made  to  the  random 
number  generator  which  will  place  a  new  random  number 
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into  the  general  simulation  table.  A  test  is  then  made 
between  the  probability  of  falling  out  of  the  LOOP  ON 
PROBABILITY  and  the  random  number  provided.  If  the 
random  number  provided  is  less  than  the  probability 
of  falling  out  of  the  LOOP  ON  PROBABILITY  instruction 
the  current  loop  address  and  loop  counter  values  are 
zeroed  and  a  RETURN  is  executed  transferring  control 
back  to  the  calling  subroutine.  If  the  random  number 
provided  is  greater  than  the  probability  of  falling  out 
of  the  loop  instruction  th  next  sequential  instruction 
counter  is  set  to  the  transfe:-  location  specified  by 
the  loop  on  probability  statement. 

In  the  case  where  the  loop  is  not  active,  the 
transa. lion  item  is  examined  for  an  empty  loop  address 
location.  If  no  empty  loop  address  location  can  be 
found  this  means  that  a  fourth  loop  statement  has  been 
encountered,  without  the  completion  of  any  previous 
loop.  This  is  an  error  condition.  The  error  code  is 
set  to  1,  and  a  RETURN  is  executed,  transferring 
control  to  SM2.  If  an  empty  loop  address  location 
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can  bn  found  the  nn«  se^u.ntUl  instruction  address 
la  stored  into  the  loop  address,  and  the  loop  count  is 
decremented  by  one.  At  this  point,  the  loop  subrout 
if  the  loop  segment  had  been  currently  active. 


me 
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SUBROUTINE  S31  MEMORY 


The  MEMORY  subroutine  begins  by  zeroing  all 
internal  counters.  It  then  examines  the  queue  paxameter 
of  the  MEMORY  statement  to  see  if  the  transaction  item 
for  which  the  memory  test  is  being  made  is  on  a  queue, 
of  transaction  items  in  the  current  operating  CPU.  If 
the  transaction  item  is  on  a  queue,  the  MEMORY  subroutine 
accesses  the  transaction  word  from  the  queue  entry  tab^e. 
If  the  transaction  item  is  not  on  a  queue,  it  must  be  the 
available  transaction  for  the  current  CPU.  From  the 
transaction  item,  the  MEMORY  subroutine  accesses  the 
worker  routine  base  address.  From  the  worker  routine 
base,  the  memory  subroutine  S( ts  AIP  equal  to  the  number 
of  instruction  pages  required  for  this  transaction  item. 
It  then  sets  ADP  equal  to  the  number  of  data  pages  and 
AIOP  equal  to  the  number  of  10  pages.  If  the  10  alloca¬ 
tion  switch  in  the  general  simulation  table  is  less 
than  zero,  the  memory  sxibroutine  sets  the  number  of  10 
pages  required  (AIP)  equal  to  0.  If  the  worker  routine 
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for  which  memory  is  being  allocated  is  reentrant,  and 
there  is  an  active  transaction  item  associated  with 
that  worker  routine,  the  number  of  instruction  pages 
(AIP)  is  also  set  to  O. 

At  this  point,  the  MEMORY  subroutine  tests  the 
memory  allocation  code  stored  in  the  general  simulation 
table.  If  the  memory  allocation  code  is  equal  to  1, 
the  number  of  contiguous  pages  will  be  equal  to  the 
number  of  instruction  pages  required  rounded  up  to  the 
nearest  integer.  In  addition,  the  number  of  noncontiguous 
pages  required  will  be  equal  to  the  sum  of  the  number  of 
data  pages  and  the  number  of  10  pages  rounded  up  to  the 
nearest  integer.  If  the  memory  allocation  code  is  equal 
to  2,  the  number  of  contiguous  pages  will  bo  equal  to  the 
sum  of  the  number  of  data  pages  and  the  number  of  10 
pages  required,  rounded  up  to  the  nearest  integer.  In 
addition,  the  number  of  noncontiguous  pages  will  be 
equal  to  the  number  of  instruction  pages  rounded  up.  If 
the  memory  allocation  code  is  equal  to  3,  there  will  be 
two  pieces  of  contiguous  memory  required.  The  instruction 


pages  required  will  be  allocated  as  one  contiguous  section 
and  the  suin  of  the  data  pages  and  the  10  pages  required 
will  be  allocated  as  a  separate,  but  also,  contiguous 
area.  At  this  point,  the  memory  subroutine  will  set  the 
largest  contiguous  pages  required  equal  to  the  larger  of 
these  two  areas,  and  the  secondary  contiguous  storage 
required  equal  to  the  lessor  of  these  two  areas.  If  the 
memory  allocation  code  is  equal  to  4,  all  of  the  memory 
requirements  will  be  considered  noncontiguous.  Therefore, 
the  noncontiguous  pages  required  will  b(  ret  equal  to  the 
sum  of  the  10  pages,  the  data  pages  and  the  instruction 
pages  rounded  up  to  the  nearest  integer  value.  If  the 
memory  allocation  code  is  equal  to  5,  all  memory  require¬ 
ments  will  be  considered  to  be  contiguous. 

The  memory  subroutine  now  sets  a  pointer  to  the 
lowest  page  of  the  low  memory  specified  and  the  highest 
page  of  the  high  memory  specified.  A  scan  is  then  made 
of  all  of  the  pages  within  this  range.  The  result  of  this 
scan  is  a  pointer  to  the  address  of  the  largest  contiguous 
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area  of  storage  available,  a  pointer  to  the  next  largest 
area  of  contiguous  storage  available,  the  size  of  the 
next  largest  contiguous  storage  available,  the  size  of  the 
next  largest  contiguous  storage  area  and  a  count  of  the 
total  number  of  noncontiguous  pages  left.  At  this  point 
a  comparison  is  made  between  the  number  of  pages  available 
and  the  number  of  pages  required. 

If  the  largest  contiguous  storage  area  required 
is  greater  than  the  largest  contiguous  storage  area 
available,  then  a  test  to  determine  if  a  PACK  operation 
would  provide  sufficient  memory  is  made.  If  the  largest 
contiguous  area  required  can  be  satisfied,  then  the 
remaining  pages  of  the  largest  contiguous  storage  available 
is  compared  to  the  next  largest  contiguous  storage  available. 
If  the  remainino  piece  is  larger  than  the  next  contiguous 
storage  area  available,  then  the  next  largest  contiguous 
storage  available  is  added  to  the  noncontiguous  storage 
available  and  the  remainder  is  set  equal  to  the  second  largest 
contiguous  storage  available.  The  next  step  is  to  examine 
if  the  second  largest  contiguous  storage  area  required  can 
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be  supplied  out  of  the  second  largest  contiguous  storage 
available.  If  this  storage  cannot  be  supplied,  then  the 
test  to  determine  if  a  PACK  operation  would  provide  suffi¬ 
cient  memory  is  made.  If  the  second  largest  contiguous 
storage  area  can  be  satisfied,  then  the  remaining  test 
is  to  see  if  there  is  sufficient  noncontiguous  storage 
available  to  satisfy  those  requirements.  If  this  test 
can  be  satisfied,  then  the  memory  test  is  considered  to 
be  successful  and  the  appropriate  exit  line  address  is 
set  into  the  general  simulation  table.  In  addition,  most 
of  the  information  calculated  by  the  MEMORY  subroutine  is 
stored  into  the  general  simulation  table  for  use  by  the 
ALLOCATE  subroutine.  At  this  point  a  RETURN  is  executed 
and  control  is  transferred  back  to  SM2. 

In  the  event  that  a  test  to  determine  if  a 
PACK  operation  would  supply  sufficient  memory  is  required, 
all  of  the  available  pages  are  added  into  one  counter  and 
all  of  the  required  pages  are  added  into  a  second  counter. 
If  the  total  number  of  required  pages  is  less  than,  or 
equal  to  the  total  number  of  available  pages,  then  a  PACK 
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would  supply  sufficient  memory.  In  this  event,  the 
appropriate  exit  line  is  set  into  the  general  simula¬ 
tion  table  I  a  RETURN  is  executed,  and  control  is  passed 
back  to  SM2.  If  the  test  for  a  PACK  operation  is 
unsuccessful,  then  the  no  memory  exit  line  is  set  into 
the  general  simulation  table  and  a  RETURN  is  executed, 
also  transferring  control  bac’t  to  SM2, 


SUBROUTINE  S32  ALLOCATE 


The  ALLOCATE  subroutine  examines  the  parameters 
placed  in  the  general  simulation  table  by  the  MEMORY 
subroutine,  and  determines  if  the  available  transaction 
in  the  current  operating  CPU  is  the  same  transaction  for 
which  the  memory  statement  was  executed.  If  this  test  is 
not  satisfied,  the  error  code  is  set=l  and  a  RETURN  is 
executed.  The  ALLOCATE  subroutine  next  tests  to  determine 
if  a  PACK  was  required,  but  not  executed.  If  this  is 
true  the  error  code  is  set=2  and  a  RETURN  is  executed. 

If  no  error  conditions  exist,  the  ALLOCATE  subroutine 
calls  S210,  the  Reset  emory  Load  subroutine.  When  control 
is  returned  to  the  ALLOCATE  subroutine  a  test  is  made  to 
determine  if  a  PACK  has  been  perfu’';aed  after  the  MEMORY 
statement  was  executed,  but  before  this  ALLOCATE  state¬ 
ment.  If  a  PACK  was  performed,  then  the  pack  code  in 
the  reneral  simulation  table  is  set  equal  to  0  and  a 
scan  is  mace  to  determine  th?  lowest  page  which  is  empty 
in  the  memory  range  specified.  Once  titis  scan  has  been 
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completed,  all  memory  requirements  are  allocated  starting 
at  the  first  free  page  as  a  single  contiguous  area.  At 
this  point  a  RETURN  is  executed  and  control  is  passed 
back  to  SM2. 

If  a  PACK  was  not  performed,  then  memory  will 
be  allocated  into  the  areas  determined  by  the  MEMORY  sub¬ 
routine.  When  allocating  storage  for  a  transaction  item, 
the  transaction  word  for  that  transaction  item  is  stored 
into  the  page  table.  The  exception  to  this  rule  is  the 
allocation  of  instruction  storage  for  a  reentrant  worker 
routine.  In  this  case,  the  worker  routine  base  address 
is  placed  into  the  page  table  as  a  negative  integer,  rather 
than  the  transaction  word.  This  allows  deallocation  of 
data  and  10  storage  without  deallocating  the  instruction 
storage.  The  allocation  is  p'lrformed  by  starting  at 
the  address  of  the  largest  contiguous  storage  area  avail¬ 
able,  as  passed  by  the  MEMORY  subroutine  and  allocating 
the  largest  number  of  pagf"'  required.  The  subroutine 
next  starti:  at  the  address  of  the  second  largest  contiguous 
area  of  storage  available,  and  allocates tho  second  largest 


number  of  pages  required.  The  allocate  subroutine  next 
sets  a  pointer  to  the  lowest  page  in  the  memory  range 
specified.  It  then  allocates  all  noncontiguous  storage 
required  from  any  free  page  available.  If  any  of  the 
three  allocating  loops  detects  a  page  which  is  not  empty 
when  it  should  be,  the  error  code  is  set  equal  to  3  and 
a  RETURN  is  executed. 

Upon  completion  of  the  ALLOCATE  subroutine,  the 
fields  set  in  the  general  simulation  table  by  the  MEMORY 
subroutine  are  cleared,  and  the  next  sequential  instruc¬ 
tion  counter  is  set  to  zero.  At  this  point  the  run  class 
pointer  in  the  transaction  item  is  set  equal  to  the 
current  CBJ  number,  and  a  1  is  added  to  the  number  of 
transaction  items  with  memory  allocated  counters  in  the 
worker  routine  base.  A  RETURN  is  then  executed  trans¬ 
ferring  control  back  to  . 
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SUBROUTINE  S3 3  DEALLOCATE 

The  DEALLOCATE  subroutiiiG  first  calls  the 
Reset  Memory  Load  subroutine  S210.  Upon  receiving  control 
back,  the  DEALLOCATE  subroutine  scans  the  memory  page  table 
for  nagcF  containing  a  transaction  word  equal  to  the 
available  transaction  in  the  current  operating  CPU.  Each 
of  these  pages  is  set  equal  to  0.  If  the  transaction 
for  which  storage  is  being  deallocated  is  not  reentrant, 
a  1  is  subtracted  from  the  count  of  transaction  items 
with  memory  allocated  in  the  worker  routine  base,  the 
Set  Memory  Load  subroutine  S211  is  called,  the  next 
sequential  instruction  is  set  to  equal  0,  and  a  RETURN 
is  executed,  transferring  control  back  to  SM2 . 

If  the  transaction  for  which  storage  is  being 
deallocated  is  reentrant,  a  test  is  made  to  see  if  the 
number  of  transactions  with  memory  allocated  is  greater 
than  1,  If  it  is  greater  than  1,  the  action  taken  is  the 
same  as  for  a  nonreentrant  transaction  item.  If  the 
number  of  active  transaction  items  is  equal  to  1 ,  a  new 


scan  is  made  through  the  memory  page  table  in  order  to 
deallocate  all  instruction  pages  for  the  transaction  item. 
These  pages  are  identified  as  having  the  negative  worker 
routine  base  address  in  the  page  entry.  At  this  point  a 
1  is  subtracted  from  the  number  of  transaction  items  with 
memory  allocated  in  the  worker  routine  base,  the  Set 
Memory  Load  subroutine  S211  is  called,  the  next  sequential 
instruction  counter  in  the  general  simulation  table  is 
set  equal  to  zero,  and  a  RETURN  is  executed. 
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SUBROUTINE  S34  PACK 


The  PACK  subroutine  calls  the  Reset  Memory 
Load  subroutine  S210.  Upon  return  of  control  to  the 
PACK  subroutine  it  sets  a  pointer  to  the  low  page  and 
the  high  page  in  the  memory  range  specified.  The  PACK 
subroutine  then  proceeds  to  move  all  occupied  pages  to 
the  low  end  of  the  range  and  0  all  pages  at  the  high 
end  of  the  memory  range.  Upon  completion  of  this 
operation  the  PACK  subroutine  calls  the  Load  Memory 
subroutine  S211,  resets  the  next  sequential  instruction 
counter  in  the  general  simulation  table,  and  if  a  PACK 
was  required  it  sets  the  pack  performed  code  into  the 
general  simulation  table.  At  this  point  a  RETURN  is 
executed  and  control  is  transferred  back  to  SM2. 
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SUBROUTINE  S35  EXAMINE-FIRST 


The  EXAMINE-FIRST  subroutine  accesses  the 
queue  number  from  the  general  simulation  table.  It 
then  resets  the  queue  pointer  to  the  queue  start  address, 
sets  the  queue  increment  equal  to  1  and  the  queue  limit 
equal  to  the  queue  end  in  the  general  simulation  table. 

A  test  is  then  performed  to  see  if  the  first  entry  in 
the  queue  is  equal  to  zero.  If  the  first  entry  is  0, 
the  next  sequential  instruction  counter  in  the  general 
simulation  table  is  set  equal  to  0  and  a  RETURN  is  executed. 
If  the  first  entry  in  the  queue  is  not  equal  to  0,  a  test 
is  made  to  determine  if  the  queue  entry  is  capable  of 

j 

running  in  the  current  CPU,  If  the  current  entry  is 
capable  of  running  the  next  sequential  instruction  code 
in  the  general  simulation  table  is  set  equal  to  1,  and 
a  return  is  executed.  If  the  current  entry  in  the  queue 
is  not  capable  of  running  in  the  current  CPU,  then  the 
EXAMINE-FIKST  subroutine  will  go  back  to  look  at  the  next 

% 

item  on  the  queue. 
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SUBROUTINE  S36  EXAMINE-NEXT 


The  EXAMINE-NEXT  subroutine  accesses  the  queue 
to  be  examined  from  the  general  simulation  table.  If  the 
queue  pointer  in  the  queue  table  is  set  equal  to  the 
queue  limit,  as  set  by  the  examine  first  or  examine  last 
subroutines,  the  NSI  pointer  in  the  general  simulation 
table  is  set  equal  to  zero  and  a  RETURN  is  executed. 
Otherwise,  the  queue  increment  as  set  by  the  EXAMINE- 
FIRST,  or  EXAMINE-LAST  subroutine  is  added  to  the 
current  queue  pointer  and  the  current  queue  entry  is 
examined  for  zero.  If  the  current  queue  entry  is  equal 
to  zero,  the  next  sequential  instruction  counter  in  the 
general  simulation  table  is  set  equal  to  zero  and  a  RETURN 
is  executed.  If  there  is  a  current  entry  in  the  queue, 
the  current  entry  is  tested  to  see  if  it  can  run  in  the 
current  CPU.  If  the  current  entry  can  run,  the  next 
sequential  instruction  counter  is  set  equal  to  1  and  a 
RETURN  is  executed.  Otherwise,  the  no  find  exit  line  is 
set  in  the  general  simulation  table  and  a  RETURN  is  executed. 
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SUBROUTINE  S37  EXAMINE-LAST 


The  EXAMINE-LAST  subroutine  perforins  the  same 

functions  as  the  EXAMINE-FIRST  subroutine,  with  the 

following  exceptions. 

1)  The  queue  pointer  is  initialized  to 

the  queue  end  rather  than  the  queue 


start . 

2)  The  queue  increment  is  set  equal  to  minus 
1  rather  than  plus  1. 

3)  The  queue  limit  is  set  equal  to  the  queue 
start  rather  than  the  queue  end. 
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SUBROUTINE  S38  PLACE 


The  PLACE  subroutine  first  determines  the  queue 
number  from  the  PLACE  statement  in  the  general  simulation 
table.  If  the  queue  specified  is  full,  the  error  code 
is  set  equal  to  4,  and  a  RETURN  is  executed.  If  the 
queue  is  not  full, a  test  is  made  to  see  that  the  rule  that 
only  AT's  may  be  placed  on  AT  queues,  and  only  lOT's 
may  be  placed  on  lOT  queues,  has  not  been  violated.  If 
this  rule  has  been  violated,  an  error  code  of  1  is  set 
and  a  return  is  executed,  A  test  is  then  made  to  see  if 
a  zero  item  is  being  placed.  If  a  zero  item  is  being 
placed,  the  error  code  is  set  equal  to  a  2,  and  a  RETURN 
is  executed.  If  the  item  being  placed  is  a  negative  AT, 
the  PLACE  is  ignored  and  the.  AT  is  set  equal  to  0.  This 
eliminates  cycle  transaction  words  from  piling  up  on 
queues.  Next  a  test  is  made  to  determine  the  queuing 
method  for  the  queue  specified  in  the  place  statement. 

If  the  queueing  method  for  the  queue  selected 
is  priority,  the  item  being  placed  is  inserted  in  t'  - 
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queue  just  ahead  of  the  first  transaction  with  lower 
priority.  If  the  queueing  method  specified  is  first 
in,  first  out,  the  item  being  placed  is  put  after  the 
last  entry  currently  on  the  queue.  If  the  queueing 
method  for  the  queue  selected  by  the  place  statement  is 
last  in,  first  out,  the  item  being  placed  goes  at  the 
top  of  the  queue. 

Once  the  item  has  been  placed  on  the  queue 
the  appropriate  word  in  the  CPU  item  is  set  equal  to 
zero.  The  current  number  of  entries  on  the  selected 
queue  is  incremented  by  1,  and  the  previous  load  is 
calculated.  The  queue  load  is  calculated  by  multiplying 
the  elapsed  time  by  the  number  of  entries  on  the  queue. 
If  the  current  number  of  entries  on  the  queue  is  greater 
than  the  maximum  number  at  any  previous  time,  the 
maximum  number  of  entries  field  in  the  queue  table  is 
set  equal  to  the  current  number  of  entries.  At  this 
point,  the  last  reference  time  in  the  queue  table  is  set 
equal  to  the  current  clock  time.  A  1  is  also  added  to 
the  total  number  of  place  operations  on  this  queue.  In 
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addition,  the  queue  start  time  for  the  AT  or  lOT  placed 
on  the  selected  queue  is  now  set  equal  to  the  current 
clock  time.  The  queue  pointer  is  then  reset  to  the 
queue  start  and  a  RETURN  is  executed,  transferring  control 
back  to  SM2. 


•  \ 
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SUBROUTINE  S39  SELECT 


The  SELECT  subroutine  accesses  the  queue  number 
from  the  SELECT  statement  in  the  general  simulation  table. 
It  then  tests  the  entry  in  the  queue  entry  table  pointed 
to  by  the  queue  pointer  for  a  zero.  If  the  entry  is 
zero,  the  error  code  is  set  equal  to  1  and  a  RETURN  is 
executed.  If  the  current  queue  item  is  not  zero,  the 
queue  type  is  then  compared  with  the  item  specified  for 
selection  by  the  SELECT  statement.  If  the  queue  type 
is  wrong,  the  error  code  is  set  equal  to  2,  and  a  RETURN 
is  executed.  If  the  queue  type  is  correct,  the  SELECT 
subroutine  next  tests  tlie  appropriate  slot  in  the  CPU 
item  to  insure  that  no  item  is  overlaid  by  the  select 
statement.  If  an  item  would  be  overlaid  by  this  SELECT, 
the  error  code  is  set  equal  to  3,  and  a  RETURN  is  executed. 
The  transaction  item  for  the  10  transaction  vjord  is  then 
accessed,  and  a  test  is  made  to  determine  if  the  run  class 
is  equal  to  zero.  If  the  run  class  is  not  equal  to  zero, 
a  test  is  made  to  determine  if  the  current  CPU  is  capable 
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of  running  this  transaction.  If  the  current  CPU  may  not 
run  this  transaction  the  error  code  is  set  equal  to  4, 
and  a  RETURN  is  executed.  If  the  run  class  pointer  was 
equal  to  zero,  a  test  is  made  to  determine  if  the  current 
CF*U  is  able  to  load  the  transaction  being  examined.  If 
the  current  CPU  may  not  load  the  transaction  under 
examination,  the  error  code  is  also  set  to  4,  and  a  RETURN 
is  executed. 

If  the  current  CPU  is  able  to  either  run  or 
load  the  transaction  under  examination,  the  transaction 
word  is  extracted  from  the  queue  and  placed  into  the  . 
appropriate  word  of  the  CPU  item.  The  queue  is  then 
compacted  to  eliminate  the  space  created  by  the  extracted- 
transaction  word.  The  queue  statistics  are  then  updated 
in  the  same  way  as  for  the  PLACE  subroutine.  Each  time 
a  select  statenent  is  executed,  a  now  record  is  generated 
by  the  select  subroutine  and  placed  into  a  table  local  to 
this  subroutine,  Wlicn  100  such  records  have  been  accumu¬ 
lated  a  block  of  records  is  written  out  to  Fortran  unit 
number  18.  These  records  are  examined  by  the  STATl 
routine  and  queue  statistics  are  dovcli^ped  from  this 
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information  at  the  end  of  a  simulation  run.  Upon  comple¬ 
tion  of  the  PLACE  operation  the  queue  pointer  for  the 
selected  queue  is  set  equal  to  the  queue  start  location. 

A  RETURN  is  then  executed  and  control  is  passed  back  to 
SM2. 
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SUBROUTINE  S40  BUFF 


The  BUFF  subroutine  accesses  the  AT  out  of  the 
current  operating  CPU.  From  this  AT  it  extracts  the 
current  file  request.  The  current  file  request  is  an 
ordinal  file  number  placed  into  the  transaction  item  by 
the  read/write/print  subroutines.  If  the  ordinal  file 
number  is  positive,  the  10  operation  requested  is  an 
input  operation.  If  the  ordinal  file  number  is  negative 
the  10  operation  will  be  an  output  operation.  The  BUFF 
subroutine  next  tests  to  see  if  the  ordinal  file  being 
examined  is  open.  This  test  is  by  passed  for  operating 
system  transactions  since  they  do  not  have  to  open  their 
files.  If  this  test  is  failed,  the  error  code  is  set 
equal  to  101,  which  will  not  terminate  the  simulation, 
SlOl  the  Error  Handler  is  called.  Next  the  buffer  count 
for  this  ordinal  file  is  tested  for  zero.  If  the  buffer 
count  is  equal  to  zero,  the  next  sequential  instruction 
counter  in  the  general  simulation  table  is  set  equal  to 
2,  and  a  RETURN  is  oxecuteil,  unl<'ss  the  transaction  being 
examined  is  an  operatinn  system  t  ren' ,vct  i  on .  Tf  the 


buffer  count  is  equal  to  zero  for  an  operating  system 
transaction,  an  10  transaction  item  is  generated  and  the 
next  sequential  instruction  counter  is  set  equal  to  3 
before  a  RETUKiN  is  executed. 

If  the  buffer  count  for  the  ordinal  file  being 
examined  is  not  equal  to  0,  the  record  count  is  reduced 
by  1.  If  the  record  count  is  now  equal  to  0,  the  buffer 
count  is  also  reduced  by  1 .  If  the  record  count  is  not 
equal  to  zero  now  the  next  sequential  instruction  counter 
is  set  equal  to  zero  and  a  RETURN  is  executed.  If  the 
buffer  count  has  just  been  reduced  by  1  an  10  transaction 
item  is  generated  by  a  call  to  S204,  and  the  record  count 
is  reset  to  the  number  of  records  contained  by  a  single 
buffer.  A  test  is  then  performed  to  determine  if  the  10 
transaction  item  generated  was  the  result  of  a  print 
operation.  If  it  is,  the  number  of  print  lines  to  be 
skipped  after  this  10  operation  is  performed,  are  stored 
into  the  10  tran3^^ction  item.  In  any  event,  the  next 
sequential  instruction  counter  is  now  sot  to  1,  and  a 
RETURN  is  executed. 
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SUBROUTINE  S41  SEEK 


The  SEEK  subroutine  accesses  the  10  transaction 
word  from  the  current  operating  CPU.  From  the  10  trans¬ 
action  item  it  obtains  the  device  number  and  from  the 
device  table  it  obtains  the  address  of  the  device  class 
entry  associated  with  this  device.  If  the  device  type 
is  not  random  access,  the  next  sequential  instruction 
counter  is  set  equal  to  1  and  a  RETURN  is  executed.  In 
this  event,  a  SEEK  is  not  required. 

If  the  device  is  a  random  access  device,  then 
the  to-from  table  address  in  the  device  set  table  is 
tested  for  zero,  if  the  to-from  table  address  is  zero’ 
this  means  that  there  is  only  one  file  on  "this  device 
and  there  will  be  no  seek  time  involved.  In  this  caso  the 
next  sequential  instruction  counter  is  also  set  equal  to 
1  and  a  RETURN  is  executed.  If  the  to-from  table  address 
is  not  equal  to  zero,  then  the  to-from  table  is  accessed 
using  the  current  real  file  number  as  the  "TO"  file  and 
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the  last  file  accessed  from  the  device  table  as  the 
"FROM"  file.  If  the  to-from  entry  recessed  is  negative, 
this  means  that  a  search  operation  must  be  performed  and 
no  SEEK  will  be  required.  In  this  event  the  next  sequen¬ 
tial  instruction  counter  is  set  equal  to  1,  and  a  RETURN 
is  executed.  If  the  to-from  table  entry  accessed  is 
positive,  the  10  transaction  item  type  is  set  equal  to 
3,  indicating  a  SEEK  operation  will  be  performed  and  the 
lOADVANCE  subroutine  S43  is  called.  In  this  event  the 
next  sequential  instruction  counter  is  set  equal  to  zero 
and  a  RETURN  is  executed.  If  this  exit  line  is  taken 
the  10  transaction  word  from  the  current  operating  CPU 
has  been  set  equal  to  0. 
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SUBROUTINE  S42  lOREADY 


The  lOREADY  subroutine  first  teststo  determine 
if  the  10  transaction  word  required  is  in  the  current 
CPU  item  or  on  a  queue.  Once  the  10  transaction  word  has 
been  obtained,  a  test  is  made  to  see  if  the  10  transaction 
item  is  a  seek  continue  or  some  other  type  of  transaction 
item.  For  a  seek  continue  10  transaction  item,  a  trans¬ 
fer  is  made  immediately  to  the  test  availability  table 
for  channel  control  unit  pair,  portion  of  the  lOREADY 
subroutine.  For  10  transaction  items  other  than  seek 
continue,  a  test  is  made  to  determine  if  the  10  transaction 
item  has  been  correctly  initialized.  If  the  10  trans¬ 
action  item  has  been  correctly  initialized,  a  test  is 
made  for  a  function  lOT,  which  is  treated  differently 
from  others.  Next,  a  test  is  made  to  determine  if  the 
file  required  by  this  10  transaction  item  is  available. 

If  the  file  is  not  either  free,  or  seized  by  this 
transaction  item,  then  the  file  is  considered  to  be 
busy  and  the  lOREADY  test  fails.  If  the  lOREADY  test 
fails,  the  next  sequential  instruction  counter  is  set 
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equal  to  zero,  and  a  RETURN  is  executed.  If  the  file  is 
available,  the  next  test  determines  whether  or  not  the 
required  device  is  available.  A  device  is  considered 
to  be  free  if  it  has  no  seizing  transaction  word,  or  if 
the  current  scxzrng  trari:>ac txon  xtem  xs  the  same  as 
the  transaction  item  which  generated  the  current  10 
transaction  item.  If  the  device  required  is  not  avail¬ 
able,  then  the  busy  exit  line  from  the  lOREADY  state¬ 
ment  is  taken.  If  both  the  file  and  the  device  are 
available,  a  test  is  made  to  determine  if  a  channel- 
control  pair  from  the  availability  table  can  be  found. 
Since  more  than  one  channel  or  control  unit  may  ,be  used 
to  access  a  single  device,  there  may  be  many  pairs  of 
channel-control  unit  paths  in  the  availability  table  for 
this  device.  Associated  with  a  channel-control  pair 
in  the  availability  table  is  a  direction  entry,  which 
indicates  whether  the  channel-control  unit  pair  may  be 
used  for  an  input,  an  output  pr  both  types  of  operations 
In  order  for  a  channel  to  be  consid'^red  free. 
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the  device  transfer  rate  for  the  operation  to  be 
initiated  roust  not  exceed  the  roaxirouro  channel  rate  on 
the  channel  selected.  For  a  roultiplexor  channel  this 
test  is  coroplicated  by  the  fact  that  the  channel  may 
operate  in  either  multiplexor  or  burst  mode. 

If  the  channel  being  tested  for  busy  is 
currently  operating  in  the  burst  mode,  it  is  auto¬ 
matically  considered  to  be  busy.  If  the  channel  being 
tested  is  operating  in  the  multiplexor  mode  and  the 
device  transfer  rate  for  the  new  10  operation  plus 
the  current  multiplexor  transfer  rate  would  exceed 
the  maximum  multiplexor  transfer  rate,  the  channel  is 
considered  busy.  For  a  selector  channel  the  busy 
test  is  very  simple  in  that  the  channel  is  either  busy 
or  free,  since  only  a  single  10  operation  may  be 
performed  at  one  time. 

If  the  lOREADY  subroutine  examines  all  of 
the-  pairs  of  channels  and  control  units  available  for 
accessing  a  single  device  without  finding  a  channel 
control  unit  pair,  then  the  lOREADY  test  is  considered 
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to  have  failed  and  the  next  sequential  instruction 
counter  is  set  equal  to  zero  and  a  RETURN  is  executed. 

If  all  of  the  requirements  can  be  satisfied,  that  is 
a  file,  device,  channel,  and  control  unit  are  all 
available,  then  the  next  sequentail  instruction  counter 
is  set  equal  to  1,  indicating  that  the  10  operation 
may  be  performed.  Before  a  return  is  executed,  however, 
the  device  number ,  control  number  and  channel  number  for 
the  10  operation  are  stored  in  the  ,10  transaction  item. 
This  information  will  be  used  by  the  lOADVANCE  subroutine. 
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SUBROUTINE  S43  lOADVANCE 


The  ICADVANCE  subroutine  begins  by  storing 
its  subroutine  number  Into  the  general  simulation 
table.  It  then  zeroes  out  a  number  of  time  fields  which 
will  be  used  to  determine  the  device,  control,  channel 
unit  times  required  for  this  10  operation.  After  deter¬ 
mining  that  the  10  transaction  item  has  been  properly 
Initialized,  a  test  is  made  to  see  whether  the  10 
transaction  item  is  a  function  transaction.  For  a 
function  10  operation,  the  device,  control  unit,  and 
channel  times  required  can  be  found  in  the  function 
table. 

If  the  current  10  transaction  is  not  for  a 
function,  the  appropriate  file  is  seized.  At  this 
point  the  device  set  table  is  examined  to  determine 
if  there  is  a  to-fror’  table  for  this  device.  If  a 
to-from  table  exists,  then  the  to-from  entry  is  accessed 
and  A  is  set  equal  to  the  to-from  time.  Next  a  test 
is  made  to  determine  whether  there  is  a  penalty  time 
associated  with  this  device.  If  there  is,  B  is  set 
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equal  to  the  penalty  time.  Next,  the  start  **-  stop 
time  and  the  device  time  for  the  current  10  operation 
are  determined. 

The  read/write  time  for  the  current  10 
operation  is  determined  by  dividing  the  buffer  length 
for  the  current  file  by  the  character -per -second 
transfer  rate  for  the  current  device,  and  multiplying 
the  result  by  1,000,000  to  give  a  transfer  time  in 
microseconds.  The  device  required  for  the  current 
10  operation  is  then  seized. 

For  a  print  10  transaction  item,  the  from 
time  is  then  calculated  by  multiplying  the  number  of 
lines  to  be  skipped  by  the  time  required  to  skip  one 
line. 

For  an  open  input  10  transaction  only,  all 
times  for  this  10  transaction  item  v,ill  be  multiplied 
by  the  number  of  buffers  required  in  order  to  simulate 
the  filling  of  all  available  buffers  at  open  time. 

For  an  open  output  transaction  item,  all  times  are  set 
equal  to  ;ero,  so  that  no  10  facilities  will  be  required 
to  perform  this  operation. 
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For  a  close  10  transaction  item,  any  file  or 
device  which  was  permanently  seized  by  a  peripheral 
statement  will  now  be  set  to  temporary  seize  for  the 
duration  of  this  10  operation.  If  the  device  required 
for  this  operation  is  a  tape  and  rewind  was  specified 
in  the  close  statement,  then  the  rewind  time  will  now 
be  added  to  the  device  time. 

For  a  seek  10  transaction,  all  times  except 
the  to-from  times  are  set  equal  to  zero.  For  a 
seek-continue  10  operation,  the  to-from  time  is  set 
equal  from  zero  and  all  other  times  are  left  as  they 
are. 

At  this  point,  the  channel  control  and  device 
times  are  summed  from  the  individual  times  , above  and 
10  statistics  arc  calculated.  The  appropriate  channel 
is  then  seized  and  a  RETURN- is  executed,  transferring 
control  back  to  SM2. 
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SUBROUTINE  S44  lOTERM 

The  lOTBRM  subroutine  accesses  the  queue 
number  from  the  current  statement  In  the  general 
simulation  table.  If  the  queue  type  is  not  equal 
to  1,  the  error  code  is  set  equal  to  1  and  a  RETURN 
is  executed.  The  queue  entry  table  is  then  accessed 
to  pick  up  the  address  of  the  transaction  item  to  be 
examined.  The  address  of  the  10  transaction  item  to 
be  examined  is  accessed  from  the  lOT  slot  in  the 
current  operating  CPU.  If  the  number  of  future  event 
chains  items  in  the  10  transaction  item  is  not  equal 
to  zero,  a  match  cannot  occur.  In  this  event,  the 
next  sequential  instruction  counter  in  T20  is  set  equal 
to  zero  and  a  RETURN  is  executed.  If  the  10  transaction 
item  was  not  generated  by  the  current  transo-ction  item, 
a  match  is  also  impossible. 

The  file  section  of  the  transaction  item 
under  examination  is  next  checked  for  any  open  file 
with  a  buffer  count  of  zero.  If  a  buffer  count  of 
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zero  exists,  this  means  that  the  current  10  requirements 
of  this  transaction  item  have  not  yet  been  satisfied. 

In  this  event,  the  NSI  in  T20  as  again  set  to  zero  and 
a  RETURN  is  executed.  If  the  buffer  counts  for  all 
open  files  are  other  than  zero,  all  10  requirements 
have  been  fulfilled,  and  this  transaction  may  be 
selected  off  a  deferred  queue.  In  this  event  the  next 
sequential  instruction  counter  in  T20  is  set  equal  to 
1  and  a  RETURN  is  executed. 
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SUBROUTINE  S45  SET  SWITCH 


The  SET  SWITCH  subroutine  a'iccsses  the 
switch  number  from  the  current  statement  in  T20,  If 
the  switch  number  accessed  is  less  than  21,  the  switch 
to  be  set  is  one  local  to  the  current  CPU.  If  the 
switch  number  accessed  is  greater  than  200,  or  greater 
than  20  and  less  than  101,  the  switch  number  is  invalid. 
In  this  event  an  error  code  is  set,  and  a  RETURN  is 
executed.  If  the  switch  number  accessed  is  greater 
than  101,  the  switch  to  be  set  is  a  global  switch, 
accessible  by  all  CPU's. 

Once  the  switch  number  has  been  validated 
and  the  appropriate  switch  type  determined,'  an  entry 
table  23  is  set  equal  to  1  indicating  that  the  switch 
is  on.  A  RETURN  is  then  executed,  transferring 
control  back  to  SM2. 
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SUBROUTINE  S46  RESET  SWITCH 


The  RESET  SWI'ICH  subroutine  performs  the 
same  tests  as  the  SET  SWITCH  subroutine.  Once  the 
validity  of  the  switch  number  and  the  type  of  switch 
to  be  sot  have  been  determined,  the  appropriate  entry 
in  T23  is  set  equal  to  a-1,  indicating  that  the  switch 
is  off.  When  this  operation  has  been  completed,  a 
RETURN  is  executed  and  control  is  transferred  back 
to  SM2, 


-97  - 


SUBROUTINE  S47  TEST  SWITCH 


The  TEST  SWITCH  subroutine  performs  the  same 
preliminary  tests  as  the  RESET  SWITCH  and  SET  SWITCH 
subroutines.  Once  the  validity  of  the  switch  number 
and  the  type  of  switch  to  be  tested  have  been  determined, 
the  appropriate  entry  in  T?.S  is  examined.  If  the  switch 
counter  to  be  examined  is  greater  than  zero,  indicating 
that  the  switch  is  on,  the  next  sequential  instruction 
counter  in  T20  is  set  equal  to  zero  and  a  RETURN  is 
executed.  If  the  switch  counter  being  examined  is 
less  than  zero,  indicating  that  the  switch  is  off, 
the  next  sequential  instruction  counter  is  set  equal 
to  one  and  a  RETURN  is  executed. 
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SUBROUTINE  S48  INTERRUPT 


The  INTERRUPT  subroutine  accesses  the  number 
of  the  CPU  to  be  interrupted  and  the  interrupt  number 
to  be  generated  from  the  current  statement  in  T20. 

A  test  is  then  performed  to  insure  that  the  interrupt 
number  is  valid  and  that  an  interrupt  address  has  been 
provided  for  the  CPU  which  is  to  be  interrupted.  If 
either  of  these  tests  fails,  the  error  code  in  T20 
is  set  equal  to  101  and  a  RETURN  is  executed.  If  the 
interrupt  to  be  generated  is  valid,  the  PEC  coda  is 
set  equal  to  the  CPU  number  plus  100,  and  the  FEC  item 
is  set  equal  to  the  interrupt  number.  The  FEC  manipulator 
time  is  then  set  equal  to  the  current  clock,  and  sub¬ 
routine  S201  is  then  called.  This  places  the  newly 
generated  FEC  code  and  item  at  the  top  of  the  future 
events  chain.  A  RETURN  is  then  executed  transferring 


control  back  to  SM2. 


SUBROUTINE  S49  DISABLE 

The  DISABLE  subroutine  accesses  the  number 
of  the  interrupt  to  be  disabled  from  the  current  state¬ 
ment  in  T20.  If  the  interrupt  number  is  equal  to  99, 
all  interrupts  are  to  be  disabled.  If  a  single  interrupt 
is  to  be  disabled  a  test  is  made  to  insure  that  the 
interrupt  specified  has  been  defined  for  the  current 
CPU.  If  the  interrupt  is  undefined,  the  error  code  is 
set  equal  to  one  and  a  RETURN  is  executed.  If  the 
interrupt  is  defined,  the  interrupt  is  disabled  by 
making  the  interrupt  address  negative,  and  a  RETURN 
is  executed. 

If  all  interrupts  for  the  current  CPU  are 
to  be  disabled,  all  positive  interrupt  addresses  for 
the  current  CPU  are  made  negative.  When  this  operation 
has  been  completed,  a  RETURN  is  executed. 
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SUBROUTINE  S50  ENABLE 


The  ENABLE  subroutine  perforins  exactly  the 
same  functions  as  the  DISABLE  subroutine,  S49,  with 
the  exception  that  the  interrupt  addresses  are  set 
positive,  rather  than  negative. 
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SUBROUTINE  S51  CLOCK 


The  CLOCK  operand  is  accessed  from  the 
current  statement  in  T20.  The  four  digit  integer 
of  the  form  DDEE  expressed  in  microseconds  is  then 
converted  to  a  real  number.  This  is  then  added  to 
the  current  simulator  time  and  stored  in  the  clock 
item  time  for  the  current  CPU.  A  RETURN  is  then 
executed  transferring  control  back  to  SM2.  When  SM2 
receives  control,  a  call  to  S103,  the  Place  Clock 
Item  on  thu  Future  Events  Chain  subroutine,  is  per¬ 
formed. 
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SUBROUTINK  S52  RETURN 

The  RETURN  subroutine  is  used  to  transfer 
control  from  the  current  operating  transaction,  which 
is  normally  an  operating  system  transaction,  to  the 
available  transaction  for  the  current  CPU.  The 
requirements  for  the  successful  execution  of  this 
subroutine  are  an  available  transaction  and  no  10 
transaction  in  the  current  CPU. 

The  RETURN  subroutine  accesses  the  current 
CPU  from  the  general  simulation  table.  If  the  10 
transaction  word  for  the  current  CPU  is  not  equal  to 
zero,  an  error  code  of  one  is  set  and  a  RETURN  is 
executed.  If  the  available  transaction  word  for  the 
current  CPU  is  equal  to  zero,  an  error  code  of  two  is 
set  and  a  RETURN  is  executed.  If  the  available  trans¬ 
action  is  negative,  indicating  a  cycle  transaction,  all 
further  tests  for  the  available  transaction  are  ignored. 
If  the  available  transaction  is  not  a  cycle  transaction, 
the  worker  routine  base  for  the  available  transaction 
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is  accessed.  The  progr.'vm  type  from  the  worker  routine 
base  is  then  stored  in  the  general  simulation  table. 

If  the  program  type  of  the  available  transaction  is 
equal  to  one,  indicating  an  operating  system  transaction, 
all  further  tests  on  the  available  transaction  is  not  for 
an  operating  system,  the  run  class  pointer  is  tested  for 
zero.  If  it  is  zero,  an  error  code  of  three  is  set  into 
T20  and  a  RETURN  is  executed.  This  indicates  that  the 
available  transaction  has  not  yet  been  loaded  and  may 
nor  be  returned  to.  If  the  run  class  pointer  is  not 
equal  to  zero,  a  test  is  made  to  insure  that  the  current 
CPU  is  in  the  available  transaction’s  run  class.  If 
the  condition  is  not  met,  an  error  code  of  four  is  set 
in  T20  and  a  RETURN  is  executed. 

Once  all  of  the  required  tests  for  the  current 
CPU  item  and  the  available  transaction  have  been  made, 
the  current  operating  transaction  is  closed  out.  Since 
the  current  operating  transaction  should  be  an  operating 
system  transaction,  the  total  CPU  t;’me,  lOT  queue  time, 
and  TI  queue  time  are  added  into  the  appropriate  fields 
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in  the  current  CP’J  item.  The  COT  slot  for  the 
current  CPU  item  is  then  set  equal  to  the  AT  slot. 

Ii  the  new  CXDT  is  a  cycle  transaction  item,  the  cycle 
start  time  for  the  current  CPU  is  set  equal  to  the 
current  time  and  a  RETURN  is  executed.  Otherwise, 
the  NSX  code  in  T20  is  set  equal  to  zero  and  the  AT 
and  lOT  slots  for  the  current  CPU  item  are  set  from 
the  current  operating  transaction  item's  hold  areas. 
At  this  point  all  entries  in  the  transaction  item 
table  occupied  by  the  old  COT  are  freed  by  setting 
the  first  word  of  each  entry  equal  to  -1.  A  return 
is  then  executed,  transferring  control  back  to  SM2. 
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SUBKOUT.INE  S53  ACTIVATE 


The  ACTIVATE  subroutine  accesses  the  current 
operating  CPU  from  the  general  simulation  table  and 
tests  to  insure  that  the  available  transaction  word 
for  the  current  CPU  is  equal  to  zero.  If  this  test 
is  not  satisfied,  an  error  code  of  one  is  set  into 
T20  and  a  RETURN  is  executed.  The  first  operand  of 
the  ACTIVATE  statement  is  then  accessed  from  the 
current  statement  in  T20.  The  v/orker  routine  base 
table  is  then  examined  to  insure  that  there  is  an  entry 
for  the  worker  routine  to  be  activated.  If  no  entry 
exists  in  the  worker  routine  base,  an  error  code  of 
two  is  set  in  the  general  simulation  table,  and  a 
RETURN  is  executed.  If  a  worker  routine  bas^  docs 
exist,  '.iubroutine  S2C3,  the  Create  Transaction  Item 
subroutine,  is  called.  Upon  return  of  this  control 
from  S203,  the  address  of  the  transaction  item  created 
will  be  found  in  the  general  simulation  table.  Thu 
creation  time  for  the  new  tr.ansaction  item  is  then  •‘et 
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nqual  to  the  current  clock  time,  and  the  total  number 
of  transaction  items  called  counter  in  the  worker 
routine  base  is  incremented  by  one.  At  this  point, 
the  available  transaction  word  in  the  current  CPU  is 
set  equal  to  tne  newly  created  transaction  item 
at'dress.  The  next  sequential  instruction  counter  in 
the  general  simulation  table  is  then  set  equal  to  zero 
and  a  RETURN  is  executed,  transferring  control  back  to 
SM2. 
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SUBROUTINE  S54  RECEIVE 


A  RECEIVE  subroutine  accesses  the  current 
operating  CPU  from  the  general  simulation  table,  it 
then  tests  to  insure  that  the  available  transaction 
word  for  the  current  CPU  item  is  equal  to  zero.  If 
this  test  is  not  successful,  an  error  code  of  one  is 
set  and  a  RETURN  is  executed.  If  the  AT  is  equal  to 
zero,  the  future  events  chain  is  searched  for  an  item 
which  has  generated  a  receive  interrupt  for  the  current 
CPU  but  has  not  yet  been  removed  from  the  chain.  If 
no  such  item  exists,  the  error  code  is  set  equal  to 
two  and  a  RETURN  is  executed.  If  the  item  is  found, 
a  pointer  is  set  to  the  address  of  the  item,  and 
subroutine  S202,  the  Reorganize  FEC  subroutine  is 
called.  Upon  return  of  control  from  S202,  a  test  is 
made  to  see  whether  the  newly  received  transaction 
item  was  generated  or  called.  For  a  called  transaction 
item,  tne  transaction  item's  address  is  stored  as  the 
available  transaction  for  the  current  CPU  and  a  RETURN 
is  executed,  transferring  control  back  to  SM2. 


For  a  generated  transaction  item,  the 
creation  time  is  set  equal  to  the  current  clock  time 
and  the  time  off  the  future  events  chain  field  is  set 
equal  to  zero.  Then  the  total  number  of  generated 
transaction  items  field  in  the  worker  routine  base  is 
incremented  by  one.  If  the  generation  limit  for  the 
newly  received  transaction  item  has  been  reached,  the 
available  transaction  word  in  the  current  CPU  item  is 
set  equal  to  the  newly  received  t-ansaction  item,  and 
a  RETURN  is  executed.  If  the  creation  limit  has  not 
been  reached,  a  new  transaction  is  generated  by 

a  call  to  S203,  the  FEC  time  for  the  newly  created 
transaction  item  is  set  equal  to  the  current  clock  time 
plus  the  spread,  either  fixed  or  poisson,  and  the  new 
transaction  item  is  placed  on  the  future  events  chain 
by  a  call  to  S201.  At  this  point,  the  available 
transaction  word  in  the  current  CPU  item  is  set  equal 
to  the  received  transaction,  and  a  RETURN  is  executed, 
transferring  control  back  to  SM2. 
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SUBROUTINE  S55  CYCLE 


The  CYCLE  subroutine  accesses  the  current 
operating  CPU  from  the  general  simv’lation  table.  A 
test  is  then  made  to  insure  that  the  AT  is  equal  to 
zero.  If  the  AT  is  not  equal  to  zero,  an  error  code 
of  one  is  set,  and  a  RETURN  is  executed.  The  lOT  fiel  J 
is  then  tested  for  zero;  if  the  lOT  is  not  equal  co 
zero,  the  error  code  is  set  equal  to  two,  and  a  RETURN 
is  executed.  If  both  of  these  tests  are  executed 
successfully,  the  current  operating  transaction  field 
is  set  negative  and  the  start  cycle  time  for  the  current 
CPU  is  set  equal  to  the  current  clock  time.  The  total 
CPU  time,  total  lOT  queue  time,  and  total  TI  queue  time 
fields  from  the  current  operating  transaction  are  then 
added  into  the  appropriate  fields  in  the  current  CPU 
item.  At  this  point  all  entries  in  the  transaction 
item  table  for  the  current  COT  are  set  free  by  initial¬ 
izing  the  first  word  in  each  entry  to  -1.  The  next 
sequentail  instruction  code  is  then  set  equal  to  zero 
and  a  RETURN  is  executed,  transferring  control  back  to 
Sr.R. 

-110- 


SUBROUTINE  S56  DESTROY 

The  DESTROY  subroutine  accesses  the  first 
operand  from  the  current  statement  in  the  general 
simulation  table.  I  ‘  the  operand  is  equal  to  one,  the 
available  transaction  will  be  destroyed  and  if  the  operand 
is  equal  to  two,  the  10  transaction  item  will  be  destroyed. 
If  the  operand  is  invalid,  an  error  code  of  one  will  be 
set  and  a  RETURN  will  be  executed. 

The  destroy  available  transaction  routine 
tests  to  insure  that  all  files  have  been  closed  and 
moves  the  total  number  of  10  opt/ at  ions  performed  by 
the  available  transaction  into  table  ITX.  If  any 
file  in  the  transaction  item  being  destroyed  has  not 
been  closed,  an  error  code  of  two  is  set  and  a  RETURN 
is  executed.  If  all  files  have  been  closed,  a  record 
is  written  out  onto  FORTRAN  unit  13,  containing  all 
the  statistics  and  the  total  number  of  10  operations 
on  each  fi’e  for  the  transaction  being  destroyed. 

Each  entry  in  the  transaction  item  table  used  by  the 
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transaction  being  destroyed  is  then  set  free  by 
initializing  the  first  word  for  each  entry  to  -1. 

The  available  transaction  word  in  the  current  CPU  item 
is  set  equal  to  zero,  and  a  RETURN  is  executed,  trans¬ 
ferring  control  back  to  SM2. 

The  destroy  10  transaction  item  routine 
examines  the  10  transaction  item  to  see  whether  the 
number  of  FEC  items  is  equal  to  zero.  If  the  number 
of  FEC  items  is  not  equal  to  zero,  there  are  additional 
pointers  to  this  transaction  item  still  on  the  future 
events  chain.  In  this  case,  the  10  transaction  word 
in  the  current  CPU  item  is  set  equal  to  :ero,  the  10 
transaction  item  is  not  destroyed,  and  a  RETURN  is 
executed.  If  the  number  of  items  on  the  .'^EC  field 
is  equal  to  zero,  this  means  that  the  10  transaction 
item  entry  in  the  10  transaction  item  table  may  be 
eliminated.  In  this  event,  the  total  10  queue  time  is 
added  to  the  total  lOT  queue  time  in  the  transaction 
item  which  generated  this  lOTI .  In  addition,  the  number 
of  10  transaction  items  outstanding  field  in  the  trans- 
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action  item  is  reduced  by  one.  The  entry  in  the  10 
transaction  item  table  is  then  freed  by  initializing 
the  first  word  to  -1,  the  10  transaction  word  in  the 
current  CPU  item  is  set  equal  to  zero,  and  a  RETURN  is 
executed,  transferring  control  back  to  SM2. 


SUBROUTINE  S57  PERIPHERAL 

The  PERIPHERAL  subroutine  accesses  the  first 
operand  from  the  current  statement  in  the  general 
simulation  table.  If  this  operand  is  equal  to  zero, 
the  transaction  item  for  which  the  peripheral  state¬ 
ment  will  be  executed  must  be  the  available  transaction 
in  the  current  CPU  item.  If  the  first  operand  is  not 
equal  to  zero,  it  must  be  the  address  of  a  queue,  from 
which  the  transaction  item  will  be  accessed.  In  this 
case,  the  queue  type  is  testei  to  insure  that  it  con¬ 
tains  only  transaction  items.  If  the  queue  type 
specifies  •'hat  it  contains  10  transaction  items,  the 
error  code  is  set  equal  to  one,  and  a  RETURN  is  executed. 
The  current  entry  as  specified  by  the  queue  pointer 
in  the  current  queue  is  then  accessed  and  used  as 
the  transaction  item  for  which  the  PERIPHERAL  state¬ 
ment  will  be  executed. 

From  the  transaction  item  specified  by  the 
PERIPHERAL  statement,  the  worker  routine  base  and  file 


vector  tables  are  accessed.  If  the  number  of  files 


used  by  this  transaction  item  is  equal  to  zero,  the 
NSI  counter  in  the  general  simulation  table  is  set 
equal  to  one,  and  a  RETURN  is  executed.  This  indicates 
that  all  10  is  available. 

For  transaction  items  which  perform  10 
operations  there  will  be  one  entry  in  the  file  vector 
table  for  each  file  referenced.  Associated  with  each 
entry  in  the  file  vector  table  is  a  seizing  code, 
which  specifies  whether  the  device,  file,  or  nothing 
should  be  seized.  The  PERIPHERAL  subroutine  examines 
each  entry  and  if  the  device  is  to  be  seized,  seizes 
it.  If  the  file  is  to  be  seized,  it  seizes  the  file. 

If  all  requirements  can  be  satisfied,  the  NSI  corie  is 
set  equal  to  1,  and  a  RETURN  is  executed.  If  all  of 
the  seizing  requirements  cannot  be  satisfied,  the  NSI 
code  is  set  equal  to  zero,  and  all  facilities  which 
have  been  seized  for  this  transaction  item  are  freed. 

At  this  point  a  RETURN  is  executed,  transferring 
control  back  to  SM2 .  Notice  th.at  if  a  transaction 
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item  attempts  to  seize  a  device  which  is  currently 
busy  that  has  not  been  permanently  assigned  to  another 
transaction  item,  the  seizing  code  is  stored  into  the 
eighth  word  of  the  device  set  table.  In  this  case  the 
device  will  be  permanently  seized  when  the  current 
10  operation  on  the  device  has  finished. 


SUBROUTINIi  S59  MMCH 


The  MATCH  subroutine  accesses  the  available 
transaction  for  the  current  CPU  and  the  first  operand 
frc’n  the  current  statement  in  the  general  simulation 
table.  If  the  queue  number  specified  in  the  match 
statement  is  equal  to  zero,  an  error  code  of  one 
is  set,  and  a  RETURN  is  executed.  Otherwise,  the 
current  queue  entry  as  specified  by  the  queue  pointer 
in  the  selected  queue  is  accessed.  If  the  queue 
specified  does  not  contain  transaction  items,  an  error 
code  of  2  is  set  and  a  RETURN  i  •  executed.  If  the 
queue  type  is  correct,  the  called  worker  routine  number 
from  the  transaction  item  on  the  queue  is  compared 
to  the  worker  routine  number  for  the  available 
transaction.  If  these  two  worker  routine  numbers  are 
not  equal,  tb*'*  NSI  code  is  set  equal  to  1,  and  a  RETURN 
is  executed,  indlc.atinn  that  no  match  has  ocen  found. 

If  the  two  worker  routine  numbers  arc  equal,  the 
calling  transaction  item  number  field  from  the  avail¬ 
able  ir.'^-.isaction  item  is  compared  to  the  address  of 
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the  transaction  item  on  the  queue.  If  these  two 
transe-ctioii  item  addresses  are  not  equal,  the  next 
sequential  instruction  code  is  set  equal  to  one  and 
a  RETURN  is  executed.  If  the  two  transact ior  tern 
addresses  are  equal,  the  next  sequential  instruction 
code  is  set  equal  to  zero,  indicating  that  a  match 
has  been  found,  and  a  RETURN  is  executed,  transferring 
control  back  to  SM2. 
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SUBROUTINE  S61  C^LOUT 


The  CALLOUT  subroutine  accesses  the  current 
CPU  from  the  general  simulation  table.  It  picks  up 
the  first  operand  from  the  current  statement  and  the 
available  transaction  for  the  current  CPU  item. 

The  program  number  to  be  called  is  then 
obtained  from  the  available  transaction  and  passed 
to  the  ACTIVATE  subroutine,  S5.'.  Upon  return  of 
control  from  the  ACTIVATE  subroutine  the  new  available 
transaction  will  be  the  newxy  called  transaction  item. 
The  original  available  transaction  is  then  restored 
and  the  PLACE  subroutine,  S38,  is  called.  The  PLACE 
subrovttlne  puts  the  original  transaction  on  the  queue 
specified  by  the  CALLOUT  statement.  When  control  is 
returned  from  the  PLACE  subroutine,  the  new  transaction 
item  is  made  th^  available  transaction  and  the  calling 
tra'^saction  item  number  is  stored  into  the  newly 
created  available  transaction.  At  this  point,  a  RETURN 
is  executi'd  and  control  is  transferred  back  to  SM2. 
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SUBHOUTINE  S62  PRIORITY 


The  PRIORITY  subroutine  accesses  the  first 
two  operands  from  the  current  statement  in  the  general 
simulation  table.  If  the  queueing  method  for  both 
queues  specified  is  not  priority,  the  error  code  is 
set  equal  to  2  and  a  RETURN  is  executed.  If  the 
queueing  method  for  both  queues  is  priority,  the  first 
entry  in  each  of  the  two  queues  is  accessed.  If 
either  or  both  of  the  two  queues  selected  contains 
10  transaction  items  then  the  transaction  item  which 
created  the  10  transaction  item  is  accessed.  At  this 
point  a  comparison  is  made  between  the  priorities  of 
two  transaction  items.  If  the  item  from  the  first 
queue  has  a  priority  of  the  item  from  the  second  queue, 
the  next  sequential  instruction  code  is  set  equal  to 
zero  and  a  RETURN  is  executed.  If  the  item  from  the 
second  queue  has  the  higher  priority,  then  the  next 
sequential  instruction  code  is  set  equal  to  1,  and  a 
RETURN  is  executed.  If  both  of  the  queues  are  empty, 


SUBROUTIi'lE  SlOl  ERROR  HANDLER 


The  ERROR  HANDLER  subroutine  examines  the 
error  code  in  the  general  simulation  table.  If  the 
error  code  found  is  less  than  100,  the  subroutine 
number  and  the  error  code  are  printed  out  with  the 
message  "SIMU’J^TION  TERMINATED".  At  this  point  any 
dump  switch  which  has  been  turned  off,  is  turned 
on  and  all  tables  are  printed  out  before  terminating 
the  simulation. 

If  the  error  code  found  is  greater  than  100, 
the  current  subroutine  number  and  the  error  code  are 
printed  out  with  the  message  "SIMULATION  CONTINUING". 

In  this  event,  a  RETURN  is  executed  which  will  transfer 
control  back  to  SM2  without  printing  out  any  of  the 


tables . 


mm 
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SUBROUTINE  S102  PUT  lOTI  ON  FEC 

The  PUT  lOTI  ON  FEC  subroutine  accesses  the 
10  transaction  item  from  the  current  operating  CPU. 

The  current  CPU  number  is  then  stored  into  that  10 
transaction  item,  and  the  current  FEC  item  is  set  equal 
to  the  10  transaction  word.  If  this  is  a  SEEK  lOTI, 
the  number  of  FEC  items  is  set  equal  to  1,  the  FEC 
code  is  set  equal  to  31,  and  the  PUT  FEC  iteration 
counter  is  set  equal  to  1,  bypassing  the  test  for 
equal  end  times. 

The  PUT  lOTI  subroutine  may  place  as  many 
as  3  occurrences  of  the  lO  transaction  item  on  the 
future  events  chain.  This  depends  on  the  number  of 
equalities  found  between  the  channel  control  and 
device  end  time.  If  all  three  end  tiroes  are  equal, 
only  one  item  is  placed  on  the  future  events  chain. 

The  FEC  code  specifies  which  facilities  are  to  be  set 
free  when  an  10  termination  occurs.  If  the  FEC  code 
is  equal  to  21,  this  item  specifies  a  channel  control 
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and  devices  end.  If  the  FEC  code  is  equal  to  22,  this 
item  specifies  a  channel  and  control  end.  If  the  FEC 
code  is  equal  to  23,  this  item  specifies  a  control 
and  device  end.  If  the  FEC  code  is  equal  to  24,  thjLS 
item  specifies  a  channel  and  device  end.  If  the  FEC 
code  is  equal  to  25,  this  item  specifies  a  channel 
end  only.  If  the  FEC  code  is  equal  to  26,  this  item 
specifies  a  control  end  only.  If  the  FEC  code  is  equal 
to  27,  this  item  specifies  a  device  end  only. 

Once  the  number  of  items  to  be  placed  on 
the  future  events  chain  has  been  determined,  a  separate 
call  is  made  to  subroutine  S201,  the  PUT  FEC  subroutine, 
for  each  item  to  go  on  the  future  events  chain.  When 
this  operation  has  been  completed,  the  10  transaction 
word  in  che  current  CPU  item  is  set  equal  to  zero 
and  a  RETURN  is  executed,  transferring  control  back  to 
the  calling  subroutine. 


SUBROUTINE  S103  PUT  CLOCK 


The  PUT  CLOCK  subroutine  sets  the  current 
PEC  code  equal  to  99|  indicating  a  clock  item,  and 
sets  the  current  PEC  item  equal  to  the  current  CPU 
number.  The  PUT  PEC  tim*e  field  in  the  general 
simulation  table  is  set  equal  to  the  next  clock 
time  from  the  current  operating  CPU.  A  test  is  then 
performed  to  determine  whether  there  is  a  current 
clock  item  for  the  current  CPU  on  the  future  events 
chain,  it  is  removed  before  the  new  clock  item  is 
placed  on  the  future  events  chain.  The  new  clock  item 
is  placed  on  the  future  events  chain  by  a  call  to 
subroutine  S201,  the  F^T  FEC  subroutine.  At  this 
point  the  clock  item  switch  is  turned  on,  indicating 
that  there  is  a  clock  item  on  the  future  events  chain 
for  the  current  CPU,  and  a  RETURN  is  executed  trans¬ 
ferring  control  back  to  SM2. 


SUBROUTIN!i  S104  PEC  MANIPULATOR 


The  FEC  KANIPJLATOR  is  used  to  place  the 
current  operating  transaction  for  the  current  CPU 
onto  the  future  events  chain.  Each  time  a  transaction 
item  is  placed  on  the  future  events  chain,  the  first 
item,  on  the  future  events  chain  for  which  the  interrupt 
is  enabled,  is  removed  from  the  chain. 

The  FEC  MANIPULATOR  sets  the  FEC  code  equal 
to  the  CPU  number  and  the  FEC  item  equal  to  the 
current  operating  transaction  word.  For  the  current 
operating  transaction,  the  time  off  FEC  field  is 
calculated  by  adding  the  advance  time  and  the  current 
clock  time.  The  time  off  FEC  field  in  the  general 
s5.mulation  table  is  then  set  equal  to  the  time  off  FEC 
field  in  the  transaction  item,  and  the  current  CPU 
number  is  stored  into  the  current  operating  transaction. 
Subroutine  S201,  the  PUT  FEC  subroutine,  is  then  called, 
placing  the  current  operating  transaction  onto  the  future 
events  chain.  Upon  return  of  control  from  S201,  the  COT 
slot  for  the  current  CPU  item  is  sot  equal  to  zero. 
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A  pointer  is  then  set  to  the  top  of  the 
future  events  chain  and  each  item  is  examined.  If  the 
PEC  code  is  less  than  zero,  the  current  FEC  transaction 
must  be  a  generated  or  called  transaction  item.  For 
these  items,  if  the  FEC  code  is  less  than  -5,  a  receiver 
interrupt  has  already  been  generated  and  the  item  on 
the  future  events  chain  is  ignored.  Therefore,  the 
pointer  is  advanced  by  one,  and  the  next  item  is 
examined.  If  the  FEC  code  is  in  the  range  from  -1  to 
>5,  a  test  is  made  to  determine  whether  the  receiver 
interrupt  has  been  disabled.  If  the  receiver  interrupt 
is  disabled,  once  again  t!te  item  is  ignored  and  the  FEC 
pointer  is  advanced  by  one.  If  the  receiver  interrupt 
is  enabled,  100  is  subtracted  from  the  FEC  code, 
indicating  that  an  interrupt  has  been  generated,  and 
the  interrupt  code  in  the  general  simulation  table  is 
set  equal  to  5.  At  this  point  the  current  operating 
CPU  number  is  set  equal  to  the  CPU  number  specified 
for  the  receipt  of  the  current  FEC  item.  If  the  time 
off  FEC  field  for  the  current  FEC  item  is  greater  than 


the  current  clock  tine,  the  current  clock  time  is 
advanced.  Control  is  then  passed  to  the  routine  which 
interrupts  the  COT  for  the  current  CPU. 

If  the  PEC  code  is  in  the  range  from  1  to  5, 
then  the  current  PEC  item  is  a  normal  transaction  item 
which  has  been  advancing  time.  In  this  event  the  current 
CPU  in  the  general  simulation  table  is  set  equal  to  the 
current  PEC  code  and  the  current  operating  transaction 
for  that  CPU  is  set  equal  to  the  FEC  itme.  At  this 
point  the  current  clock  time  is  set  equal  to  the  time 
off  FEC  for  the  current  FEC  item,  and  the  advance  trme 
is  added  to  the  total  CPU  time  for  xhat  transaction 
item.  The  time  off  FEC  and  the  advance  time  fields  for 
the  current  FEC  item  are  then  set  equal  to  zero,  and 
the  FEC  pointer  is  set  so  that  a  call  to  subroutine 
S202  laay  remove  this  item  and  code  from  the  future  events 
chain.  A  RETURN  is  then  executed,  transferring  control 
back  to  SM2. 

If  the  FEC  code  is  in  the  range  from  21  to 
31,  the  current  FEC  item  is  an  10  transaction  it«*a, 
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In  this  case  the  current  C?U  number  is  accessed  from 
the  10  transaction  item.  If  this  lOTI  is  for  a  seek 
operation,  then  the  seek  interrupt  is  tested.  If  the 
seek  interrupt  is  disabled,  then  the  next  item  on  the 
FEC  is  examined.  If  the  seek  interrupt  is  not  disabled, 
then  the  interrupt  code  in  the  general  simulation  table 
is  set  equal  to  7.  If  this  is  a  normal  lOTI,  the 
10  termination  interrupt  is  tested.  If  the  10  term¬ 
ination  interrupt  is  not  disabled,  the  interrupt  code 
is  set  equal  to  1.  The  FEC  pointer  is  then  set  to  the 
current  FEC  item  and  a  call  to  subroutine  S.202  removes 
that  item  from  the  future  events  chain.  The  current 
clock  time  in  T20  is  then  advanced  to  the  appropriate 
•end  time  in  the  10  transaction  item.  The  lOTW  is 
stored  as  the  next  10  transaction  item  in  the  current 
operating  CPU.  At  this  point,  control  is  passed  to 
the  routine  which  interrupts  the  current  operating 
transaction  for  the  current  operating  CPU. 

If  the  FEC  code  is  equal  to  99  the  current 
FEC  item  is  a  clock  transaction.  In  this  event  the 
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current  CPU  number  is  set  equal  to  the  FEC  item.  If 
the  clock  interrupt  is  disabled,  this  item  on  the 
future  events  chain  is  ignored  and  the  pointer  is 
advanced  by  1.  If  the  interrupt  is  enabled,  the  clock 
item  switch  in  the  current  CPU  item  is  set  equal  to 
zero,  indicating  that  there  is  no  clock  item  on  the 
future  events  chain,  and  the  interrupt  code  in  T20  is 
set  equal  to  4.  The  current  simulator  time  is  then 
advanced  to  the  clock  item  tne,  and  the  FEC  pointer  is 
set  to  point  to  ^  current  FEC  item,  so  that  a  call  to 
subroutine  S202  may  remove  it  from  the  future  events 
chain.  At  this  point  control  is  passed  to  the  routine 
which  will  interrupt  the  current  operating  transaction 
for  the  current  operating  CPU. 

If  the  FEC  code  is  in  the  range  from  101  to 
105,  the  current  FEC  item  is  a  generated  interrupt.  In 
this  case,  the  current  CPU  number  is  set  equal  to  the 
FEC  code  less  100,  and  the  interrupt  number  is  set  equal 
to  the  FEC  item.  If  the  interrupt  specified  is  disabled, 
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this  FEC  item  is  ignored,  and  the  FEC  pointer  is 
advanced  1,  If  this  interrupt  is  eixabled,  the  FEC 
pointer  is  stored  and  a  call  to  subroutine  S202  removes 
the  current  item  from  the  future  events  chain.  Control 
is  then  passed  to  the  routine  which  interrupts  the 
current  operating  transaction  for  the  current  operating 
CPU. 

The  routine  to  interrupt  the  current  operating 
transaction  for  the  new  current  operating  CPU  first 
examines  the  CPU  to  determine  if  it  is  cycling.  If 
the  CPU  is  cycling,  the  current  simulated  time  less 
the  start  cycle  time  is  added  to  the  total  cycle  time 
for  that  CPU.  At  this  point  a  P.ET'fJrN  is  executed  and 
control  is  transferred  to  SM2.  If  the  current  CPU  is 
not  cycling,  the  future  events  chair,  is  searched  for 
a  transaction  item  for  •'■he  current  CPU.  If  no  trans¬ 
action  item  is  found  on  tne  future  events  chain,  the 
error  code  is  set  equal  to  3  r.nd  u  RETURN  is  executed. 

Once  this  transaction  has  been  found,  the  time 
to  go  is  calculated  by  subtracting  the  time  to  go  from 
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the  original  advance  time .  The  elapsed  time  is  then 
added  to  the  total  CPU  time  used  by  this  transaction 
item  and  the  advanced  time  is  reset  using  the  new  time- 
to-go  figure.  This  transaction  item  is  then  restored 
to  its  position  as  COT  for  the  current  operating  CPU. 
The  FEC  item  pointer  is  then  stored  so  that  a  call 
to  subroutine  S202  may  remove  the  COT  entry  from  the 
future  events  chain.  A  RETURN  is  then  executed  trans¬ 
ferring  control  back  to  SM2. 
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SUBROUTINE  SI 10  INTERRUPT  HANDLER 

The  INTERRUPT  HANDLER  examines  the  current 
operating  transaction  for  the  current  operating  CPU. 

If  the  COT  is  not  negative,  the  AT  and  lOT  for  the 
current  CPU  are  stored  into  the  COT's  transaction 
item.  At  this  point  the  current  COT  is  made  the  AT 
and  the  next  lOT  is  moved  into  the  lOT  slot  for  the 
current  CPU.  If  the  original  COT  was  negative, 
indicating  a  cycle  transaction  item,  the  storing  of 
the  AT  and  lOT  is  ignored.  The  interrupt  number  is 
then  accessed  from  the  general  simulation  table  and 
a  test  is  made  to  insure  that  the  interrupt  is  not 
disabled.  If  the  interrupt  is  disabled,  the  error  code 
is  set  equal  to  6  and  a  RETURN  is  executed. 

If  the  interrupt  number  is  equal  to  7, 
indicating  an  end  of  seek  interrupt,  the  10  trans¬ 
action  item  type  is  altered  from  a  seek  to  a  seek 
continue.  At  this  point,  for  a  seek  or  any  10  term¬ 
ination  interrupt,  the  device,  channel  or  control  unit 
which  is  to  be  set  free  is  released.  Interrupts  which 
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are  not  caused  by  10  activity  bypass  this  releasing  of 
facilities  and  go  directly  to  the  routine  which  creates 
an  operating  system  transaction  item. 

In  order  to  create  an  operating  system 
transaction  item,  the  operating  system  worker  routine 
number  is  accessed  from  the  CPTI  to  be  interrupted  amd 
stored  into  the  general  simulation  table  for  use  by 
subroutine  S203.  A  call  to  subroutine  S203  then 
creates  the  operating  system  transaction  item.  Upon 
return  of  control  from  S203  the  interrupt  number  field 
is  zeroed  and  the  current  program  type  is  set  equal  to 
1.  The  current  operating  transaction  for  the  CPU  to  be 
interrupted  is  then  set  equal  to  the  newly  generated 
transaction  item.  The  interrupt  address  which  was 
calculated  for  the  test  to  insure  that  the  current 
interrupt  was  not  disabled  is  now  set  into  the  new 
COT.  This  enables  the  new  operating  system  transaction 

to  begin  executing  instructions  at  the  light  location. 

» 

In  addition,  the  creation  time  for  the  new  COT  is  set 
equal  to  the  current  simulated  time.  At  this  point  a 
RETURN  is  executed  which  will  transfer  control  back 
to  SH2. 
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SUBROUTINE  S201  PUT  FEC 


The  PUT  FEC  subroutine  examines  the  last  item 
on  the  future  events  chain  to  determine  if  the  chain  is 
full.  If  the  chain  is  full,  an  error  code  of  1  is  set 
and  a  direct  call  to  subroutine  SlOl,  the  error  handler, 
is  made.  If  the  future  events  chain  is  not  full,  the 
pointer  is  set  to  the  start  of  the  future  events  chain, 
and  the  time  each  item  is  due  to  come  off  the  chain 
i;5  compared  to  the  time  the  new  item  is  due  to  come  off 
the  chain.  As  soon  as  an  item  is  found  which  is  due  to 
come  off  the  chain  after  the  new  item,  that  item  and  all 
subsequent  items  are  moved  down  by  1  to  provide  a  space 
for  the  new  item.  At  this  point,  the  new  FEC  code  and 
the  new  FEC  item  are  placed  on  to  the  future  events 
chain  and  the  FEC  item  count  is  incremented  by  1.  A 
REIURN  is  then  executed  and  control  is  transferred 
back  to  tne  calling  subroutine. 


SUBROUTINE  S202  REORGANIZE  FEC 


The  REORGANIZE  FEC  subroutine  accesses  a 
pointer  to  the  item  to  be  removed  and  the  FEC  counter 
from  the  general  simulation  table.  The  item  after 
the  item  to  be  removed  and  all  subsequent  items  are 
then  shifted  down  from  the  chain  by  one  position, 
overlaying  the  item  to  be  removed.  Notice  that  in 
this  subroutine  the  future  events  chain  has  been 
EQUIVALENCED  to  an  integer  array.  This  allows  both 
the  FEC  code  and  the  FEC  item  for  a  single  entry  on  the 
future  events  chain  to  be  moved  with  a  single  instruction. 
W^ien  this  operation  has  been  completed,  the  last  entry 
in  the  future  events  chain  is  set  equal  to  zero  and  the 
FEC  item  count  is  reduced  by  one.  A  RETURN  is  then 
executed  transferring  control  back  to  the  calling 
subroutine. 

f 


I 


-136- 


SUBROUTINE  S203  GENERATE  TRANSACTION  ITEM 


The  GENERATE  TRANSACTION  ITEM  subroutine 
accesses  the  worker  routine  number  for  the  transaction 
to  be  generated  from  the  general  simulation  table.  If 
the  transaction  type  is  less  than  3  indicating  that  the 
transaction  will  be  for  an  C^erating  System  or  Primary 
Worker,  a  pointer  is  set  to  the  high  end  of  the  trans¬ 
action  item  table.  For  other  types  of  transaction 
items  the  pointer  is  set  to  the  start  of  the  transaction 
item  table.  The  transaction  item  table  is  then  searched 
for  a  free  entry,  which  is  indicated  by  a  -1  in  the  first 
word  of  the  entry.  If  there  is  no  free  entry  in  the 
transaction  item  table,  the  error  code  is  set  equal  to 
1,  and  the  error  handler  subroutine,  SlOl,  is  called. 

Cnee  a  blank  entry  has  been  found,  it's 
address  is  stored  back  into  T20  and  will  be  used 
as  the  address  for  the  transaction  item  until  it 
is  destroyed.  The  part  1  transaction  item  record 
will  then  be  initialized,  using  the  information  stored 
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in  the  worker  routine  base.  Once  the  part  1  record 
has  been  initialized,  the  transaction  item  table 
pointer  is  incremented  by  1  and  the  search  for  the 
next  entry  takes  place.  The  address  of  the  time 
portion  of  the  transaction  item  is  then  stored  into 
the  transaction  item  part  1  record,  and  the  time 
section  is  initialized  to  all  zeroes.  After  the  time 
section  has  been  initialized,  the  transaction  item 
table  pointer  is  again  incremented  by  1  and  a  search 
is  made  for  the  file  portion  of  the  transaction  item. 

The  address  of  this  part  2  transaction  item  entry  is 
also  stored  into  the  transaction  item  part  1.  If  this 
worker  routi*  .  has  more  that  7  files  associated  with  it, 
there  will  be  additional  part  2  transaction  item  entries 
in  the  transaction  item  table.  These  entries  are  chained 
together  using  the  last  word  of  each  entry  to  store  the 
address  of  the  next  entry.  The  last  entry  in  this  chain 
will  contain  a  zero  in  the  last  word.  When  the  trans¬ 
action  item  has  been  generated,  a  RETURN  is  executed 
transferring  control  back  to  the  calling  subroutine. 
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SUBROUTINE  S204  GENERATE  10  TRANSACTION 

The  GENERATE  lOTI  subroutine  accesses  the 
transaction  item  for  which  this  lOTI  is  to  be  generated 
from  the  general  simulation  table.  It  then  searches  the 
10  transaction  item  table  looking  for  a  blank  entry, 
which  is  indicated  by  a  -1  in  the  first  word  of  an 
entry.  If  the  lOTI  table  is  full,  the  error  code  is 
set  equal  to  1  and  the  error  handler  subroutine  SlOl 
is  called. 

Once  a  blank  entry  has  been  found  in  the  lOTI 
table,  the  transaction  item  which  created  this  lOTI 
and  the  current  CPU  are  stored  in  the  new  lOTI.  If 
this  lori  v;as  created  as  a  result  of  an  OPEN,  CLOSE, 
READ,  or  WRITE  statement,  the  real  and  ordinal  file 
numbers  are  also  stored  in  the  lOTI .  If  this  lOlI  was 
created  as  the  result  of  a  function  statement,  the  real 
and  ordinal  file  numbers  in  the  lOTI  are  set  equal  to 
tero.  All  other  entries  in  this  lOTI  are  initialized 
to  zero.  The  number  of  lOTI's  outstanding  in  the 
transaction  item  creating  this  lOTI  is  then  incremented 
by  1.  At  this  point,  a  RETURN  is  executed  and  control 

ii»  transft  rred  bacK  to  the  calling  subroutine. 
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SUBROUTINE  S210  UNLOAD  MEMORY  STATISTICS 


The  UNLOAD  MEMORY  STATISTICS  subroutine 
updates  the  memory  load  field  for  each  memory  being 
used  in  the  current  simulation.  The  memory  load  field 
in  the  memory  table  contains  an  entry  which  is  defined 
as  page  microseconds.  This  field  is  updated  by  taking 
the  current  simulator  time  and  subtracting  the  last 
memory  reference  time.  This  value  is  then  multiplied 
by  the  current  number  of  pages  busy  in  this  memory  and 
the  result  is  added  to  the  raerociy  load  field.  At  this 
point,  the  last  refere.nce  time  for  this  memory  is  set 
equal  to  the  current  simulator  cime.  When  this  operation 
has  beer,  performed  for  all  memor^’es  used  in  the  current 
simulation,  a  RETURN  is  executed  and  control  is  tr^.ns- 
ferred  back  to  the  calling  subroutine. 


SUBROUTINE  S211  SET  MEN.’ORY  LOAD 

The  SET  MEMORY  LOAD  subroutine  counts  the 
number  of  pages  busy  in  each  of  the  memories  used  by 
the  current  simulation.  The  result  of  this  accumulation 
is  stored  in  the  number  of  pages  busy  field  for  each  of 
these  memories.  When  this  operation  has  been  completed, 
a  RETURN  is  executed  and  control  is  transferred  back  to 


the  calling  subroutine 


Subroutine  S212  RANDOM  NUMBER  GENERATOR 


The  RANDOM  NUMBER  GENERATOR  subroutine  first 
stores  its  subroutine  number  into  the  general  simulation 
table.  It  then  zeroes  the  output  field  in  the  general 
simulation  table .  The  current  random  number  i  Lhen 
multiplied  by  the  random  number  seed.  The  result  of 
this  operation  is  set  positive,  and  then  converted  from 
a  binary  fraction  to  a  decimal  fraction.  The  result 
of  this  operation  is  multiplied  by  100  which  will 
provide  a  ranv„om  number  in  the  range  from  zero  to  99. 

The  value  obtained  by  this  operation  is  stored  into  the 
general  simulation  table  and  a  RETURN  is  executed 
transferring  control  back  to  the  calling  subroutine. 


-142- 


WORKING  PAPER 


SECTION  II 

FLOW  CHARTS 


PREPARED  FOR 
DEPARTMENT  OF  THE  ARMY 


UNDER 


DEFENSE  SUPPLY  SERVICE 
CONTRACT 
.^DA  49-083-OSA-3306 


BY 

C-E-I-R,  Incorj;or;»trd 
bill  River  Ro.id 
V.' A shin;;ton,  D.  C.  20016 


woRKirj;; 


'Ci\ 


‘  T 

I 

INDEX 

1 

Description 

Page 

1 

S-3  SIMULATOR 

1 

I 

MAIN  PROGRAM 

2 

1 

SMI  SIMULATOR  INITIALIZATION 

3 

1 

ZERO 

16 

1 

Cl  READ  CARD  TYPE  . 

18 

C2  READ  CARD  TYPE  2 

19 

1 

C3  READ  CARD  TYPE  3 

20 

1 

C4  READ  CARD  TYPE  4 

21 

1 

C5  READ  CARD  TYPE  5 

22 

1 

C6  READ  CARD  TYPE  6 

23 

C7  READ  CARD  TYPE  7 

24 

1 

C8  READ  CARD  TYPE  8 

25 

■ 

C9  READ  CARD  TYPE  9 

26 

1 

CIO  READ  CARD  TYPE  10 

27 

C21  READ  CARD  TYPE  21 

28 

C22  READ  CARD  TYPE  22 

29 

1 

C23  READ  CARD  TYPE  23 

30 

i 

C24  READ  CARD  TYPES  24  AND  25 

31 

1 

C26  READ  CARD  TYPE  26 

33 

1 

C27  READ  CARD  TYPE  27 

34 

1 

1 

C28  READ  CARD  TYTE  28 

35 

1 

1 

i  ■ 

1 

- -  -*4 

INDEX 


Description  Page 

C29  READ  CARD  TYPE  29  36 
C31  READ  CARD  TYPE  31  37 
C32  READ  CARD  TYPES  32  AND  33  38 
C34  READ  CARD  TYPE  34  39 
C35  READ  CARD  TYPES  35  AND  36  40 
Stl2  SIMULATION  EXEC  41 
STl  QUEUE  STATISTICS  55 
ST2  MEMORY  STATISTICS  56 
STS  FILE  STATISTICS  57 
ST4  DEVICE  STATISTICS  •  58 
ST5  CONTROL  UNIT  STATISTICS  59 
ST6  CHANNEL  STATISTICS  60 
ST7  CPU  STATISTICS  §2 
STS  QUEUE  TRANSACTION  ANALYSIS  64 
STAT  TRANSATION  ITEM  ANALYSIS  66 

t 

T  DUMP  ®8 
SNAP  69 
TRACE  -  SS51  70 
POIS  POISSON  TABLE  LOOKUP  71 
DT  1  '  ,  72 
DT  2  73 


INDEX 


I 

1 


■  Description 


DT  3 

74 

DT  4 

75 

DT  5 

76 

DT  6 

77 

DT  7 

78 

DT  8 

79 

DT  9  AND  DT  10 

80 

DT  12 

81 

DT  13 

82 

DT  14 

83 

DT  15 

84 

DT  16 

85 

DT  17 

86 

DT  18 

87 

DT  19 

88 

DT  20 

89 

DT  21 

90 

DT  22 

91 

DT  23 

92 

DT  24 

93 

Dl'  25 

94 

INDEX 


Description 


Page 


81  TRANSFIR 

95 

82  TRANSFER  ON  PROBABILITY 

96 

,'^3  READ 

97 

84  WRITE 

98 

85  FUNCTION 

99 

86~FOF 

100 

87  SUBROUTINE 

101 

88  EXIT 

102 

S9  LOOP 

103 

810  MO^'E 

104 

811  MOVE-EDIT 

105 

S12  COMPUTE 

106 

813  MATH 

107 

814  OPIN 

108 

815  CLOSED 

110 

S16  TERM 

112 

SI  7  PRINT 

114 

S18  CALL 

115 

819  EXEC 

116 

S31  MEMORY 

117 

832  ALLOCATE 

123 

833  DEALLOCATE 

128 

INDEX 


Description  Page 


S34  PACK 

129 

S35  EXAMINE  FIRST 

131 

S36  EXAMINE  NEXT 

133 

S37  EXAMINE  LAST 

134 

S38  PLACE 

135 

S3 9  SELECT’ 

138 

S40  BUFF 

140 

S41  SEEK 

141 

S42  10  READY 

•  142 

S43  10  ADVANCE 

149 

S44  10  TERM 

157 

S45  SET 

159 

S46  RESET  m 

• 

160 

S47  TEST  SW 

161 

S48  INTERRUPT 

162 

S49  DISABLE 

163 

S50  ENABLE 

• 

165 

S51  CLOCK 

166 

S52  RETURN 

167 

S53  ACTIVATE 

• 

169 

S54  RECEIVE 

• 

170 

S55  CYCLE 

172 

INDEX 


Description  Page 

556  DESTROY  173 

557  PERlPHmL  174 

S59  MATCf-  177 

561  CAUDirr  178 

562  PRIORITY  179 

SlOl  ERROR  HANDLER  181 

SI  02  PUT  lOTT  ON  FBC  182 

5103  PUT  CLOCK  ITEM  ON  PEG  186 

5104  PLACE  IT  ON  FEC  187 

SllO  INTERRUPT  HANDLER  194 

5201  PLACE  ITEM  ON  FUTURE  EVENTS  CHAIN  201 

5202  REORGANIZE  FUTURE  EVENTS  QIAIN  204 

5203  GENERATE  TI  205 

5204  GENERATE  lOTI  207 

5210  CALCULATE  MEMORY  LOAD  208 

5211  SET  MBIORY  PAGES  BUSY  209 

5212  RANDOM  NUMBER  GENERATOR  210 


CVNT 


211 


December  1,  1967 


S-3  Simulator 

The  Implicit  Coding  Convention  for  S-3 


At  the  start  of  every  subroutine  in  the  S-3  simulator  is 
an  implicit  statement  which  specifies  the  type  of  constants 
and  arrays  used  in  the  subroutine . 

Any  variable  or  array  which  begins  with  the  letters  (A-H) 
contains  a  real  single  precision  value  and  will  occupy  one 
word  in  the  System  360. 

Any  variable  or  array  which  begins  with  the  letters  (I-N) 
contains  an  integer  value  and  will  occupy  one  word  in  the 
System  360. 

Any  variable  or  array  which  begins  with  the  letters  (P-Y) 
contains  an  integer  value  and  will  occupy  one  half-word 
in  the  System  360. 

Any  variable  or  array  which  begins  with  the  letter  (Z) 
contains  a  real  double -precision  value  and  will  occupy 
two  words  (one  double  word)  in  the  System  360. 
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TABLE  DESCRIPTIONS 


Introduction 

This  chapter  describes  the  FORTRAN  tables  con¬ 
structed  by  the  simulator  machine  and  their  application 
during  the  running  of  a  simulation.  Twenty  different 
table  types  are  utilized  (table  1  through  table  21; 
there  is  no  table  11).  Since  S3  is  written  in  FORTRAN, 
the  construction  of  such  tables  is  straightforward,  and 
provides  a  simple  and  effective  method  for  the  S3 
executive  to  obtain  and  interrogate  data  during  the 
actual  simulation. 

Some  of  the  tables  described  will  be  constructed 
by  the  pre-simulator  from  static  input  data  such  as 
configuration  data  and  systems  parameters.  Other  tables 
will  be  constructed  dynamically,  as  needed,  during  the 
running  of  the  simulation.  For  example,  an  lOTI  table 
(T4)  is  constructed  when  an  I/O  is  to  be  initiated,  and 
will  be  maintained  until  the  simulated  I/O  is  complete. 


The  facility  for  maintaining  addresses  within 


one  table  to  point  to  another,  relative  table  is  a  very 
real  asset  in  executing  some  of  the  more  complex  decisions 
required  during  a  simulation.  For  example,  when  the 
S3  executive  attempts  to  initiate  an  I/O  for  a  worker 
routine,  it  will,  using  this  facility,  access  the 
following  tables: 

(T5)  Worker  Routine  Base  Table 

(T6)  File  Vector  Table 

(T14)  File  Set  Table 

(T15)  Device  Set  Table 

(T16)  Class  Table 

(T17)  Channel  Table 

(T18)  Control  Unit  Table 

From  these  tables  the  S3  executive  can  quickly 
obtain  the  information  required  to  determine  if  an  I/O 
can  be  executed  for  a  given  worker  routine,  the  peripherals 
required  and  transmission  time  for  each  of  the  peripherals. 

The  tables  also  provide  a  logical  place  to 
maintain  raw  statistical  data.  This  allows  utilization 


values,  running  time,  etc.  to  be  associated  with  a 
particular  device  or  facility  and  makes  this  in¬ 
formation  readily  available  to  the  statistics  pro¬ 
gram. 
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FUTURE  EVENTS  CHAIN  TABLE  -  T1 


PT1(1,N)  FEC  CODE 

The  FEC  CODE  defines  the  type  of  item  which  occupies 
this  entry  in  the  FEC. 

1  =  Active  transaction  item  for  CPU-1 

2  =  -2 

3  =  If  ft  n  ^3 

4  —  It  ft  II  If  _4 

5—11  If  ti  II  .5  . 

21  =  I/O  transaction  for  Channel,  Control,  &  Device 

22  =  ”  ”  Channel  &  Control 

23  =  '*  '•  Device  &  Control 

24  =  "  ”  Channel  &  Device 

25  =  "  ”  Channel 

26  =  "  "  Control 

27  =  "  "  Device 

31  =  SEEK  Interrupt 


99  =  CLCXT.K  Interrupt 


1  =  Generated  or  Called  transaction  for  CPU-1 


-2  =  *'  *' 

-3  =  "  " 

_4  =  •'  *• 

_5  —  n  II 


II 

II 

II 

II 


-2 

-3 

-4 

-5 


101-105  =  Generated  interrupt  CPU  1  to  5 
PT1(2,N)  ITEM 

This  entry  contains  the  item  which  will  be  taken 
off  the  FEC  chain. 

If  the  FEC  CODE  =  1  to  5 
ITEM  =  TW 

If  the  FEC  CODE  =  21  to  27 
ITEM  =  lOTW 
If  the  FEC  CODE  =31 
ITEM  =  lOTW 
If  the  FEC  CODE  =  99 
ITEM  =  CPU# 

If  the  FEC  CODE  =-l  to  -5 
and  the  ITEM-C0 

I  t.  M  -  CAUJiD  TI 
If  the  FEC  Cv)DE  =-l  to  -5 
and  the  TTEM^  0 


ITEM 


ooni’rAlocl  TI 
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If  the  FEC  CODE  =  101  to  105 

ITEM  =  Interrupt  #  for  interrup)t  generated  by 
INTERRUPT  statement 
If  the  FEC  CODE  =  -101  to  -105 

ITHM  =  a  generated  TI  for  which  a  receiver 
interrupt  has  been  generated,  but 
which  has  not  yet  been  taken  off  the 
FEC  by  the  REClilVE  statement. 
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CPU  ITEM  TABLE  -  TP 


IT2(1,N)  COT 

The  COT  is  the  field  containing  the  address  of  the 
current  operating  transaction  in  T3. 

IT2(2,N)  AT 

The  AT  is  the  field  containing  the  address  of 
the  available  transaction  in  T3.  This  field  must  be 
zero  when  the  COT  is  a  worker  routine. 

IT2(3,N)  lOT 

The  lOT  is  the  field  containing  the  address  of 
the  current  I/O  transaction  in  T4,  This  field  must  be 
zero  when  the  COT  is  a  worker  routine. 

IT2(4,N)  OS  Program  Number 

This  field  contains  the  address  of  the  entry  in 
the  worker  routine  base  table  T5  for  the  operating  sys¬ 
tem  controlling  this  CPU. 

IT2(5,N)  NOT  USED  . 

IT2(6,N)  to  IT2(15,N)  M!-MOFaES 

These  fields  contain  the  addr«'sses  of  entries  in 
the  memory  table  T7  for  each  mersofy  aecv'ss  i  h.le  by  this 


CPU. 
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IT2(16,N)  to  IT2(35,N)  CHANI'IELS 

These  fields  contain  the  addresses  of  entries  in 
the  channel  table  T17  for  each  channel  accessible  by 
this  CPU. 

IT2{36,N)  INTERRUPT  1  /iDDRESS 

This  field  contains  the  address  in  the  statement 
table  which  will  be  accessed  by  the  OS  transaction 
generated  for  a  number  1  interrupt. 

IT2(37,N)  INTERRUPT  1  COUNTER 

This  field  contains  a  counter  for  the  number  of 
times  an  interrupt  number  1  has  occurred. 

IT2(38,N)  to  IT2(75,N) 

PAIRS  OF  INTERRUPT  ADDRESSES  AND  COUNTERS. 
IT2(76,N)  to  IT2(78,N) 

IT2(79,N)  CPU  ID 

This  field  contains  the  CIU  identification  num¬ 
ber  from  the  CPU  definition  card  whic.  defines  this  CPU. 
IT2(80,N)  LOGICAL  DATA  UNIT 

This  field  contains  the  Icgica'*  data  unit  size 
in  bits,  AS  used  by  this  CPU. 

112(01, N)  NUMBER  OF  DECIMAL  DlGiTS 

This  fieUl  cont.'xins  the  number  r.f  decim.vl  lioits 
used  to  determine  the  decimal  add,  multi[)ly,  and  divide 
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times 


AT2,(82,N)  DECIMAL  ADD  TIME 

This  field  contains  the  time  in  micro  seconds 
to  perform  a  decimal  add  upon  two  fields  of  the  length 
given  by  IT2(81,N). 

AT2(83,N)  DECIMAL  MULTIPLY  TIME 

This  field  contains  the  time  in  micro  seconds 
to  perform  a  decimal  multiplication  upon  two  fields 
of  the  length  given  by  IT2(81,N). 

AT2(84,N)  DECIMAL  DIVIDE  TIME 

This  field  contains  the  time  in  micro  seconds 
to  perform  a  division  between  two  fields  of  the  size 
given  by  IT2(81,N). 

AT2(85,N)  FIXED  POINT  .ADD  TIME 

This  field  contains  tbe  time  in  micro  seconds 
to  perform  a  fixed  point  addition  between  two  normal 
fixed  point  fields. 

AT2(H6,N)  FTXFD  POINT  MULTIPLY  T I ND- 

This  field  contains  the  time  in  micro  seconds 
to  perform  a  fixetl  point  mn  1 1  i  p  1  i  cal  i  t>n  betwe('i!  two 
normal  fi\»'d  paint'  fielc.s. 
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AT2(87,N) 


FIXED  POINT  DIVIDE  TIME 


This  field  contains  the  time  in  micro  seconds 
to  perform  a  fixed  point  division  between  two  normal 
fixed  point  fields. 

AT2(88,N)  FLOATING  POINT  ADD  TIME 

This  field  contains  the  time  in  micro  seconds 
to  perform  a  floating  point  addition  between  two  nor¬ 
mal  floating  point  fields. 

AT2(89,N)  FLOATING  POINT  MULTIPLY  TIME 

This  field  contains  the  time  in  micro  seconds 
to  multiply  two  normal  floating  point  fields. 

AT2(90,N)  FLOATING  POINT  DIVIDE  TIME 

This  field  contains  the  time  in  micro  seconds 
to  divide  two  normal  floating  point  fields. 

IT2(91,N)  INSTRUCTION  LENGTH 

This  field  contains  the  instruction  length  for 
this  CPU  in  logical  data  units. 

IT2(92,N)  DECIMAL  DIGITS  PER  LOGICAL  DATA  UNIT 

This  field  contains  the  number  of  decimal  digits 
contained  in  one  logical  data  unit. 

IT2(9T,N)  CHARACTERS  PER  lOGTCAl.  DATA  UNIT 

This  field  contains  the  number  of  characters  con- 
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tained  in  one  logical  data  units, 

AT2(94,N)  MOVE  TIME  PER  CHARACTER 

This  field  contains  the  time  in  micro  seconds 
to  move  one  character  from  one  location  to  another. 
AT2(95,N)  MOVE  AND  EDIT  TIME  PER  CHARACTER 

This  field  contains  the  time  in  micro  seconds  to 
move  and  edit  one  cnaracter  from  one  location  to  another. 
IT2(96,N)  to  IT2(103,N)  FIXED  POINT  TABLE 

These  fields  contain  the  fixed  point  tables  des¬ 
cribed  in  the  CPU  definition  description. 

IT2(104,N)  to  IT2(109,N)  FLOATING  POINT  TABLE 

These  fields  contain  the  floating  point  tables 
described  in  the  CPU  definition  description. 

AT2(110,N)  GIBSON  TIME 

This  field  contains  the  average  instruction 
access  and  execution  time  expressed  in  micro  seconds. 
ZT2(56,N)  CLOCK  ITEM  TIME 

This  field  contains  the  time  at  which  the  current 
clock  item  (if  any)  for  the  CPU  on  the  future  events 
cliai  n  (FEC)  is  due  to  create  a  CLOCK  interrupt. 
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ZT2(57,N)  TOTAL  OS  TIME 

This  field  contains  the  total  aimount  of  operating 
system  CPU  time  supplied  by  the  CPU  at  the  current  time 
expressed  in  micro  seconds. 

ZT2(58,N)  TOTAL  OS  lOT  QUEUE  TIME 

This  field  contains  the  total  amount  of  time 
which  I/O  transaction  items  for  the  operating  system 
have  been  queued. 

ZT2(59,N)  START  CYCLE  TIME 

This  field  contains  the  last  time  a  CYCLE  state¬ 
ment  was  interpreted  by  this  CPU. 

ZT2(60,N)  TOTAL  CYCLE  TIME 

This  field  contains  the  total  amount  of  time 
in  micro  seconds  which  this  CPU  has  spent  cycling. 
ZT2(61,N)  TOTAL  OS  TI  QUEUE  Tir.IE 

This  field  contains  the  total  amount  of  time  in 
micro  seconds  which  operating  systems  transaction  items 


have  been  queued. 


TRANSACTION  ITEM  TABLE  -  T3 


TRANSACTION  ITEM  PART  I 

IT3(1,N)  WORKER  -  ROUTINE  POINTER 

-1  =  ENTRY  IS  NOT  BEING  USED 
This  entry  contains  the  address  of  the  worker 
routine  base  in  (T5)  with  which  this  transaction  is 
associated. 

IT3(2,N)  CURRENT  FILE  REQUEST 

This  entry  contains  the  ordinal  file  #  of  the 
current  read  -  write  request  for  this  transaction 
This  field  should  be  filled  by  the  READ  and  WRITE 
statements  and  set  to  cero  by  the  BUFF  statement. 
IT3(3,N)  TRANSACTION  ITEM  ID 

This  entry  contains  the  identification  number  of 
this  transaction  item.  This  field  is  generated  as 
follows  PPNNNN.  Wlierc  PP  is  the  worker  routine  base  # 
and  NNNN  is  the  number  of  this  transaction. 

IT3(4,N)  RUN  CU^SS  POINTER  . 

This  entry  conti»ins  either  a  zero  or  the  entry  i 
the  run  class  table  (PTIO)  which  lists  the  CPU's  whicli 
can  run  thi  s  t  ransac- 1  i  on  . 
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This  field  is  filled  by  the  ALLOCATE  subroutines. 
If  the  field  is  zero,  this  transaction  has  not  been 
loaded  and  may  not  be  run. 

IT3(5,N)  PRIORITY 

This  entry  contains  the  priority  of  this  trans¬ 
action  item.  This  entry  is  used  by  the  PLACE  sub¬ 
routine. 

IT3(6,N)  NSI  LOCATION 

This  entry  contains  the  location  of  the  next 
sequential  statement  to  be  interpreted  in  the  state¬ 
ment  table  by  the  worker  routine  or  operating  system 
routine. 

IT3(7,N)  #IOT  OUTSTANDING 

This  entry  gives  the  total  number  of  I/O  trans¬ 
action  items  associated  with  this  transaction,  which 
are  currently  active  in  the  system. 

IT3(8,N)  PROGRAM  TYPE 

1  =  operating  system 

2  =  primary  worker 

3  =  commercial  worker 

4  =  scientific  worker 
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IT3(9,N)  CPU  #  FOR  FEC 

This  entry  gives  the  number  of  the  CPU  which  placed 
this  transaction  item  on  the  future  events  chain.  This 
field  is  filled  and  used  by  the  future  events  chain  mani¬ 
pulator  . 

IT3(10,N)  LOOP  ADDRESS  -  1 

This  field  holds  the  address  of  the  first  LOOP 
statement  encountered. 

IT3(11,N)  LOOP  COUNTER  -  1 

This  field  holds  the  count  from  the  first  LOOP 
statement  encountered. 

IT3(12,N)  TO  IT3(15,N) 

Additional  loop  addresses  and  counters. 

IT3(16,N)  SUBROUTINE  EXIT  -  1 

The  return  address  of  the  first  subroutine  called. 
IT3(17,N)  and  IT3(I8,N) 

Additional  subroutine  return  addresses. 

IT3(19,N)  PRINT  LINES 

Number  of  lines  to  be  skipped  as  specified  in 
last  PRINT  statement. 
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IT3(20,N)  USE  CODE 

A  -1  in  this  field  indicates  this  entry  is  a 
Part  I  TI. 

IT3(21,N)  TIME  POINTER 

This  entry  contains  the  address  of  the  time  entry 
in  the  transaction  item  table  (T3)  associated  with 
this  transaction  item. 

IT3(22,N)  PART  -  2  -  POINTER 

This  entry  contains  the  address  of  the  file 
description  entry  in  the  transaction  table  (T3)  associated 
with  this  transaction  item. 
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TIME  ENTRY  -  T3 


ZT3(1,N)  CREATION  TIME 

This  entry  contains  the  time  at  which  this  trans¬ 
action  first  reached  the  top  of  the  future  events  chain, 
was  created  by  an  ACTIVATE  statement  or  was  called  by 
a  TERM  statement. 

ZT3(2,N)  TIME  DUE  OFF  FEC 

This  entry  contains  the  time  at  which  this  trans¬ 
action  is  due  to  come  off  of  the  future  events  chain. 

This  field  is  used  by  the  future  events  chain  manipu¬ 
lator, 

ZT3(3,N)  ADVANCE  TINE 

This  entry  contains  the  amount  of  time  this  trans¬ 
action  item  will  spend  on  the  future  events  chain. 
ZT3(4,N)  TOTAL  CPU  TI^E 

This  entry  contains  the  total  of  all  advance 
times  associated  with  this  transaction  item. 

ZT3(5,N)  TI  QUEUE  START  TINE 

This  entry  contains  the  time  at  which  this  trans¬ 
action  itoM!  vvas  plac<'d  on  a  quoue  v.!;on  i  is  on  a  queue. 
This  field  is  se;  by  the  PLACuC  stateiuenl  .'lul  s<'t  to  ;cero 
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by  the  SELECT  statement. 

ZT3(6,N)  TI  TOTAL  QUEUE  TIME 

This  entry  contains  the  total  time  this 
transaction  item  spent  on  all  queues.  This  field 
is  accumulated  by  the  SELECT  statement. 

ZT3(7,N)  lOT  TOTAL  QUEUE  TIME 

This  entry  contains  the  total  time  all  lOT's 
associated  with  this  transaction  spent  on  queues.  This 
time  is  accumulated  to  each  time  an  lOT  is  DESTROYED. 
ZT3(8,N)  TOTAL  I/O  TIME  USED 

This  field  contains  a  total  of  all  of  the 
device  times,  for  all  devices  accessed  by  this  trans¬ 
action,  used  up  to  the  current  time.  This  field  is 
incremented  by  the  lOADVANCE  subroutine,  and  is  used 
to  determine  dynamic  priority. 

IT3(19,N)  AT  SAVE 

This  field  is  used  to  store  the  current  AT 
whenever  a  transaction  (COT)  is  interrupted.  Upon 
the  execution  of  a  RETURN  statement,  making  the  AT 
the  COT  again,  the  value  of  this  fiuld  Is  moved  to  the 
AT  for  the  current  CPU,  item,  and  this  field  is  set 
to  zero. 
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IT3{20,N)  lOT  SAVE 

This  field  is  used  to  store  the  current  lOT 
whenever  a  transaction  (COT)  is  interrupted.  This 
field  is  handled  exactly  like  the  AT  SAVE  field  above. 
IT3(21,N)  CALLING  TI  NUMBER 

This  entry  contains  the  transaction  number  of 
the  transaction  which  called  this  transaction.  This 
entry  is  used  only  if  this  transaction  was  created  by 
a  CALL  statement. 

IT3(22,N)  CALLED  PROGRAM  # 

This  entry  contains  the  worker  routine  number 
of  the  last  worker  routine  called  by  this  transaction. 
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TRANSACTION  ITEM  FILE  SECTION  -  PART  II 


IT3(1,N)  BUFFER  COUNT 

This  entry  contains  the  number  of  buffers  which 
are  empty/full  for  this  file.  Each  time  this  count 
is  decremented  by  a  BUFF  statement,  a  new  lOT  is 
generated.  Each  time  an  lOT  comes  off  of  the  future 
events  chain  for  this  file  this  field  is  incremented. 
IT3(2,N)  RECORD  COUNT 

This  entry  contains  the  number  of  records  currently 
available  in  this  file.  This  field  is  decremented  by  a 
BUFF  statement  until  it  is  zero  at  which  time  the  BUFFER 
count  is  decremented  and  the  record  count  is  reset  from 
tht  FILE  SET  table  (T14). 

AT3(3,N)  TOTAL  I/O  OPERATIONS 

This  entry  contains  the  total  number  of  blocks 
of  data  contained  in  this  file. 

ITi(22,N)  PART  -  3  -  POINTER 

If  there  are  more  ih.an  seven  files  associated  with 
this  Ix'ansaction  item  this  field  cont.'>>ns  a  chain  add¬ 
ress  to  tnc  next  entry. 
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I/O  TRANSACTION  TABLE  -  T4 


IT4(1,N)  TI  POINTER 

This  entry  contains  the  address  of  the  transaction 
item  associated  with  this  I/O  transaction. 

IT4(2,NJ  #  FEC  ITEN:^- 

This  field  io  used  if  this  I/O  transaction  re¬ 
quires  multiple  items  to  be  placed  on  the  future  events 
chain.  This  field  is  used  by  the  FEC  manipulator. 

IT4(3,N)  TYPE  CODE 

This  field  defines  what  kind  of  T /O  transaction 

this  is. 

0  =  READ  -  WRITE 

1  =  OPEN 

2  =  CLOSE 

3  =  SEEK 

4  =  SEEK  -  CONTINUE 

5  -  FUNCTION 

6  =  PRINT 

A  READ  -  WRITE  TOT  is  generated  by  the  BUFF  state¬ 
ment.  An  OPEN  lOT  is  go-'-^ated  by  the  OPEN  statement.  A 
CLOSE  lOT  is  generated  by  a  CLOSIi:  statement  .  A  SEEK  lOT 
is  generated  by  a  SEEK  statemont .  A  SEEK  -  CONTINUE  lOT 
is  generated  by  the  SEEK  inter  rue*  routine  upon  the  com¬ 
pletion  of  a  seek  operati<in.  A  FUNCTION  lOT  is  generated 
by  A  FUNCTION  statement. 


IT4(4,N) 


CPU  #  (FEC) 
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This  field  contains  the  number  of  the  CPU  which 
placed  this  lOT  on  the  future  events  chain.  This  field 
is  used  by  the  future  events  chain  manipulator. 

IT4(5,N)  CHANNEL  # 

This  field  is  filled  by  the  10  READY  statement 
auid  contains  the  number  of  the  channel  which  will  be 
used  by  this  TOT.  If  this  field  is  positive  the  channel 
is  a  selector  and  if  this  field  is  negative  this  channel 
is  a  multiplexor.  The  selector  or  multiplexor  must  be 
released  when  the  lOT  comes  off  the  FEC. 

IT4(6,N)  CONTROL  UNIT  # 

* 

This  field  is  filled  by  the  10  READY  statement 
with  the  .jumber  of  the  CONTROL  unit  tc  be  used  by  this 
I/O  ansaction.  This  fields  is  set  negative  by  10  READY 
and  positive  b’/  10  ADVANCE  as  a  check  that  the  10  HEADY 
has  been  f?erforincd.  The  control  unit  specified  in  this 
field  must  be  released  when  this  lOT  comes  oft  he  FEC. 
IT4(7,N)  DEVICE  # 


Tills  field  is  filled  by  the  10  READY  statemotit  with 
the  number  of  the  Dl  VICE  to  be  used  by  this  roy.  xhe 


10  ADVANCE  siatenent.  This  devicv'  mu'  i  be  re  lea^-ed  tvficrj 
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this  lOT  comes  off  of  the  FEC  unless  this  is  a  SEEK  lOT 


or  the  device  has  been  assigned  for  the  exlusive  use  of 
a  worker  routine, 

IT4(8,N)  REAL  FILE  # 

This  field  is  filled  for  all  lOT  except  those 
generated  by  a  FUNCTION  statement.  This  field  must  be 
filled  when  an  lOT  is  generated. 

IT4(9,N)  ORDINAL  FILE  # 

This  field  is  used  just  like  ‘■he  REAL  FILE  #. 
IT4(10,N)  FUNCTION  # 

This  field  is  used  by  a  FUNCTION  lOT's,  When 
used  it  will  contain  the  entry  in  the  function  table  to 
be  used  by  this  lOT. 

for  a  CIjOSE  IOT  a 

1  =  no  rewind 

2  =  rewind 

for  PRINT  IOT 


U  -  FORM  ADVANCE  TIMES 


ZT4(6,N)  CHANNEL  END  TIME 

This  field  contains  the  time  at  which  the  channel 
should  be  released  from  this  I/O  operation.  This  time 
is  calculated  by  the  10  ADVANCE  statement. 

ZT4(7,N)  CONTROL  END  TIME 

This  field  contains  the  time  at  which  the  con¬ 
trol  unit  should  be  released  from  this  I/O  operation. 
This  time  is  calculated  by  the  10  ADVANCE  statement. 
ZT4(8,N)  DEVICE  END  TIME 

This  field  contains  the  time  at  which  the  device 
should  be  released  from  this  I/O  operation.  This  time 
is  calculated  by  the  10  ADVANCE  statement. 

ZT4(9,N)  QUEUE  START  TIME 

This  field  contains  the  time  at  which  tliis  I/O 
transaction  was  placed  on  a  queue,  when  it  is  on  a 
queue.  This  field  is  set  by  the  PLACE  statement  and 
set  to  zero  by  the  SELECT  ^teinent . 

ZT4(10,N)  TOTAL  QUEUE  TIME 

This  field  contains  the  total  time  this  I/O 
transaction  nas  spent  on  a  queue.  This  field  is  added 
to  the  TI  when  the  lOT  is  destroyed. 
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WORKER  ROUTINE  BASE  TABLE  -  T5 


AT5(1,N)  SPREAD 

The  time  interval  between  generation  of  trans¬ 
action  items  for  this  worker  routine.  If  this  field 
is  positive  the  spread  is  fixed,  if  this  field  is 
negative  the  spread  is  poisson. 

IT5(2,N)  LIMIT 

The  total  number  of  transaction  items  to  be 
generated. 

AT5(3,N)  TOTAL  NUMBER  GENERATED 

The  total  number  of  transactions  generated  for  . 
this  worker  routine  by  the  above  two  statements. 

IT5(4,N)  LOAD  CLASS  POINTER 

The  address  of  an  entry  in  the  LOAD  CLASS  TABLE 
(T9)  which  specifies  the  CPU's  capable  of  loading  this 
worker  routine. 

ITS('3,N)  PKIOHITY 

The  priority  associated  with  this  workt'r  routine. 
This  priority  will  govern  all  transaction  items  arul  I/O 
trail  sac  t  i  on  i  ('M'i-.  . 


IT5(6,N)  FIRST  INSTRUCTION  LOCATION 

The  entry  in  the  statement  table  (T22)  which  con¬ 
tains  the  first  executable  instruction  for  this  worker 
routine . 

IT5(7,N)  REENTRANT  -  NONREENTRANT  CODE 

A  code  specifying  whether  this  worker  routine  is 
reentrant  or  not. 

1  =  nonreentrant 

2  =  reentrant 

ITS ( 8 , N )  PROGRAM  TYPE 

A  code  specifying  the  instruction  class  available 
to  this  worker  routine. 

1  =  Operating  System 

2  -  Primary  Worker  Routine 

3  =  Commercial  Worker 

4  =  Scientific  Worker 

IT5(9,N)  NUMBER  OF  TRANSACTION  ITEMS  OUTSTANDING 

A  counter  containing  the  number  of  transaction 
items  for  this  routine  currently  in  memory.  This  counter 
must  be  incremented  by  1  when  a  TI  is  loaded  and  decre¬ 
mented  when  an  ^T  is  removed  from  memory. 

IT5(in,N)  RECEIVING  CPU  NUNniER 

The  number  of  the  CPU  which  is  to  be  interrupted 
when  <i  transaction  item  referencing  this  routine  first 
reaches  the  top  of  the  future  events  chain. 


IT5(11,N) 


NUMBER  OF  MlJiS 


The  total  number  of  files  associated  with  this 

■  routine . 

IT5(12,N)  FILE  VECTOR  TABLE  ENTRY 

The  first  entry  in  the  file  vector  table  for  this 
routine.  This  entry  corresponds  to  ordinal  file  number 
one , 

AT5(13,N)  INSTRUCTION  STORAGE 

The  number  of  pages,  in  decimal  form,  of  storage 
required  for  instructions  in  this  program. 

AT5(14,N)  DATA  STORAGE 

The  number  of  pages,  in  decimal  form,  required  for 
data  in  this  program. 

AT5(15,N)  I/O  STORAGE 

The  number  of  pages,  in  decimal  form,  required  for 
I/O  in  this  program. 

IT5(16,N)  TOTAL  NUMBER  OF  TT  GENERATED 

The  total  number  of  transactions  generated  for 
this  routine  by  means  of  the  ACTfVATE  or  TERM  statement. 
A-IT5(17,N)  +2 

A-IT5(18,N)  THE  TOTAI,  NUMiJIiR  OF  TRANSACl TONS  GENERATED 
FOR  Tins  WORKER  R-Uri  lNE 
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WORKER  ROUTINE  FILE  VECOTR  TABLE  -  T6 

PT6(1,N)  REAL  FILE  NUMBER 

This  entry  contains  the  number  of  the  real  file 
associated  with  this  ordinal  file  entry. 

To  obtain  a  real  file  from  an  ordinal  file, 

N  =  N1+IT5(12.,N2)-1 
N3  =  PT6(1,N) 
where 

N1  =  ordinal  file  number 
N2  =  worker  routine  base  number 
N  =  file  vector  total  entry 
N3  =  real  file  number 
PT6(2,N)  NUMBER  OF  BUFFERS 

This  entry  contains  the  number  of  buffers 
available  for  this  ordinal  file. 

PT6(3,N)  SEIZING  COOK 

t 

This  entry  contains  a  code  used  by  the  PF,Rrr-1iERAI. 
subroutine  to  determine  v/hat  files  and  devices  (if  any) 
should  be  seized, 

1  =  DON'T  SF.r/f’;  ANVTll  I NG 

2  =  SEIZE  FJI>: 

3  =  SEIZE  FILE  AND  DEVICF^  -30- 


PT6(4,N) 


NOT  USED 


MEMORY  TABLE  -  T7 


IT7(1,N)  LOW  PAGE 

The  number  of  the  entry  in  the  PAGE  TABLE  (T8) 
for  the  lowest  page  in  this  memory. 

IT7(2,N)  HIGH  PAGE 

The  number  of  the  entry  in  the  PAGE  TABLE  (T8) 
for  the  highest  page  in  this  memory. 
ir7(3,N)  NUMBER  OF  PACKS 

The  total  number  of  PACK  operation  performed 
upon  this  memory. 

IT7(4,N)  NUMBER  OF  NO  MEMORY  EXITS 

The  total  number  of  tines  this  memory  was  tested 
by  a  MEMORY  subroutine  and  insufficient  memory  was  found. 
IT7 { 5 , N )  PAGES  BUSY 

The  total  numlicr  of  pages  in  this  memory  which 
are  currently  busy. 

IT7(6,N)  NOT  USED 

ZT7(4,N)  LAST  REFERENCE  TIME 

This  entry  contains  the  last  time  this  memory  was 
ref  ere need . 

ZT7  (  5  ,  N )  MliMORY  LOAD 

This  entry  contains  the  t<jtal  memory  load  cxj)ressed 
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in  PAGE  MICROSECONDS  applied  to  this  memory  up  to  the 
last  reference  time. 


-33- 


PAGE  TABLJE  -  T8 

PT8(N)  PAGE  ENTRY 

This  entry  contains  a  value  which  indicates 
if  this  page  of  simulated  memory  is  currently  busy 
and  if  so,  which  transaction  is  utilizing  this  page. 
0  =  Page  free 
+N  =  Page  used  by  TI  #N 

-N  =  Page  used  by  W/R  #N  for  reentrant  code 


LOAD  Cl  ASS  TABI^  -  T9 


PT9(1,N)  to  PT9(5,N)  1.OAD  CLASS  ENTRY 

The  entries  xn  this  table  will  contain  the  load 
class  values  as  supplied  by  the  S/P  load  class  state 
ment,  and  will  specify  the  CPU’s  capable  of  loading 
worker  routine.  The  value  of  N  may  not  exceed  15, 


RUN  CLASS  TABLE  -  TIP 

PT10{1,N)  to  PT10(5,N)  RUN  CLASS  ENTRY 

The  entries  in  this  table  will  contain  the  lan 
class  values  as  supplied  by  the  S/P  run  class  state- 
ment  and  will  specify  the  CPU’s  capable  of  executing  a 
worker  routine.  The  value  of  N  may  not  exceed  5. 


-a«- 


QUEUE  TABLE  -  T12 


IT12(1,N)  QUEUE  START 

This  entry  contains  the  address  of  the  first 
item  in  the  Queue  Entry  table  (T13)  related  to  the  speci¬ 
fied  queue  (N). 

IT12(2,N)  QUEUE  END 

This  entry  contains  the  address  of  the  last  item 
in  the  Queue  Entry  table  (T13)  related  to  the  specified 
queue  (N). 

IT12(3,N)  QUEUE  POINTER 

This  entry  contains  the  address  of  the  current 

item  in  the  Queue  Entry  tab?.e  (T13)  for  the  specified 
queue  (N).  This  pointer  is  set  and  modified  by  the 
EXAMINE  statements  and  used  by  the  SELECT  statement. 

After  Execution  of  PLACE  and- SELECT  statements,  the 
pointer  is  set  equal  to  the  queue  start  address. 

IT12(4,N)  ENTRY  TYPE 

f 

This  entry  indicates  whether  the  contents  of 
this  queue  represent  transaction  itesm  or  I/O  trans¬ 
action  items. 

1  =  TT 

2  =  lOTI 
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IT12 ( 5 , N )  QUEUING  METHOD 

This  entry  indicates  the  contents  of  this  queue 

o 

axe  organized  by  program  priority  or  on  a  first-in-first- 
o.tt  or  last~in~first-out  basis. 

1  ~  program  priority 

2  =  FIFO 

3  =  LIFO 

IT12(6,N)  MAXIMUM  ENTRIES 

This  entry  indicates  the  maximum  number  of  entries 
on  the  specified  queue  during  the  current  simulation. 

This  entry  is  affected  only  by  the  PLACE  statement. 
IT12(7,N)  CURRENT  ENTRIES 

This  entry  indicates  the  number  of  items  cur¬ 
rently  present  on  the  specified  queue.  This  entry  is 
affected  by  both  the  PLACE  and  SELECT  statements. 

IT12(8,N)  NOT  USED 

ZT12(5,N)  LAST  REFERENCE  TIME 

This  entry  indicates  the  last  time  at  which  the 

contents  of  the  specified  queue  were  altered.  This 

entry  is  used  by  the  PLACE  and  SELECT  statements  to 
calculate  the  queue  load. 
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ZT12(6,N)  QUEUE  LOAD 

This  entry  is  used  to  accumulate  the  total  load 
on  the  specified  queue.  Each  time  the  contents  of  the 
queue  are  altered  by  a  PLACE  or  SELECT  statement,  the 
current  load  is  calculated  and  added  to  the  previous 
contents  of  this  entry. 
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QUEUE  ENTRY  TABLE  ■  T13 


PT13(N)  QUE  ENTRY 

This  table  is  used  to  hold  all  TW's  associated 
with  queues.  It  can  contain  2000  entries  that  may 
be  divided  among  up  to  30  queues  as  the  user  sees  fit. 
The  limits  of  a  named  queue's  entries  In  this  table 
are  defined  by  that  queue's  relative  Queue  Staort  and 
Queue  End  entries  in  the  Queue  Table  (T12 ) . 
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FILE  SET  TABLE  -  T14 


IT14(1,N)  SEIZING  ID 

This  field  contains  the  identification  of  the 
transaction  currently  using  this  file.  If  this  field 
is  zero  the  file  is  free.  If  this  field  is  negative 
it  contains  the  number  of  the  trainsaction  item  which 
seized  this  file  by  a  itTlRIPHERAL  statement.  If  this  field 
is  positive  it  contains  the  number  of  the  I/O  trans¬ 
action  currently  using  this  file. 

IT14(2,N)  DEVICE  # 

This  field  contains  the  identification  of  the 
device  upon  which  this  file  is  resident.  This  infor¬ 
mation  comes  from  the  system  parameters. 

1T14(3,N)  RELATIVE  LOCATION 

This  field  contains  the  relative  number  of  this 
file  on  the  device.  This  information  is  used  to  access 
the  TO"FROM  table.  If  this  entry  is  negative  it  means 
that  this  is  the  only  file  on  the  device.  This  infor na¬ 
tion  comes  from  system  parameters. 


IT14(4,N)  BUFFER  LENGTH 

This  field  contains  the  length  of  each  physical 
record  on  this  file.  This  information  comes  from  sys¬ 
tem  parameters. 

l'T14(5,N)  RECORDS  PER  BUFFER 

This  field  is  used  by  the  BUFF  statement  to  reset 
the  number  of  records  available  when  a  buffer  has  been 
en^t ied/f i lied . 

IT14(6,N)  NUMBER  OF  BLOCKS  IN  FIiJe 

This  field  is  used  by  the  EOF  statement  to 

determine  whether  this  file  is  ended. 

ZT14(4,N)  SEIZE  START  TIME 

This  field  contains  the  time  at  which  this  file 
was  seized.  This  field  is  filled  by  the  10  ADVANCE 

statement  when  an  OPEN  statement  seizes  a  file.  This, 
field  is  reset  to  zero  when  the  file  is  cloced. 

ZT14(5,N)  TOTAL  SEIZE  TIME 

» 

This  field  contains  the  total  amount  of  time  this 
file  was  seised.  This  field  time  is  accumulated  each 
time  the  file  is  released  by  a  CLOSE  statement. 

ZT14(6,N)  I/O  TIME 

This  field  contains  the  total  device  time  associ¬ 
ated  with  using  this  file.  This  field  is  added  to  each 
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time  an  10  ADVANCE  is  executed  for  this  file 


I 

I 

I 

I 

I 

I 

T 
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DBVICB  SBT  TABLE  -  T15 

ITl5(:i,N)  SEIZING  ID 

This  entry  contains  the  identification  of  the  TI 
or  lOTI  which  has  seized  the  device.  If  this  field  is 
zero  the  device  is  free.  If  this  field  is  negative  it 
contains  the  address  of  a  transaction  item  which  has 
seized  this  device  in  a  PERIPHERAL  statement.  If  this  field 
is  positive  it  contains  the  address  of  an  I/O  trans¬ 
action  item  now  on  the  FEC  using  this  device. 

IT15(2,N)  AVAILABILITY  TABLE  ADDRESS 

This  eitxy  contains  the  address  of  the  first 
entry  in  the  availability  table  (T16)  indicating  a 
channel  control  unit  path  to  this  device.  The  last  entry 
in  the  availability  table  associated  with  this  device  will 
be  adnus  in  the  first  field. 

IT15(3.N)  DEVICE  CLASS  TABLE  ADDRESS 

This  entry  contains  the  address  of  this  device 
class  table  (T19)  which  contains  the  fixed  information 
about  a  specific  device  type. 
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IT15(4,N)  TO-FROM  TABLE  ADDRESS 

This  entry  contains  the  address  of  the  first 
entry  in  the  TO-PR(^  table  (T24)  associated  with  the 
device , 

IT15(5,N)  TO-FRCM  TABLE  WIDTH 

This  entry  contains  width  of  the  TO-FROM  table 
associated  with  this  device.  To  access  on  entry  in  the 
TO-FROM  table  multiply  the  number  of  the  row  to  be  accessed 
by  the  table  width,  add  the  number  cf  the  column  and  the 
table  address  from  above.  This  gives  the  address  of  the 
entry  to  be  accessed. 

IT15(6,N)  RELATIVE  LOCATION  OF  LAST  FILE 

If  there  is  more  than  one  file  on  this  device,  each 
time  a  file  on  this  device  is  rcferen  ;ed  the  lOADVANCE 
routine  stores  the  relative  location  of  the  file  being 
referenced  into  this  field.  When  referencing  the  TO- 
FROM  table,  this  is  the  FRC»1  file  a.td  the  ew  fi,^e  to  be 
accessed  is  the  10  file. 

IT15(7,N)  SEI7.ABLE  DEVICE  CODE 

This  entry  contains  a  code  which  tells  the  system 
if  this  device  can  bo  seised  or  not.  If  an  0«‘^N  statoment 
attempts  to  seise  a  device  j»hlch  is  classed  an  '  t.'n* 
seixable,  the  file  will  seixed  rather  than  the  vsv'vice. 


1  -  seizablc  device 


2  s  nonselzable  device 
IT15(8,N)  PERIPHERAL  SEIZING  ID 

This  field  is  used  by  the  PERIPHERAL  subroutines 
to  indicate  that  a  new  worker  routine  wishes  to  seize 
this  device,  although  at  the  time  of  the  PERIPHERAL  state¬ 
ment  the  device  was  busy. 

Upon  receipt  of  a  device  I/O  termination  the 
interrupt  subroutine  SllO  checks  this  field  and  if  it 
is  non  zero  moves  this  field  to  the  seizing  ID. 

ZT15(5,N)  LAST  END  TIME 

This  entry  contains  the  time  at  vihich  the  last 
I/O  operation  on  this  device  ended.  This  time  is  set 
by  the  lOADVANCE  routine  and  is  used  to  determine  penalty 
time. 

ZT15(6,N)  TOTAL  SEEK  TIME 

This  entry  contains  the  total  seek  time  used  by 
the  device.  Normally  this  field  should  be  zero  for  all 
devices  other  than  random  access.  This  field  is  used  by 
the  lOADVANCE  statement. 
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ZT15(7,N)  TOTAL  NON-SEEK  TIME 


This  field  contains  the  2jnount  of  time  this  device 
was  busy  performing  operations  other  than  SEEKING.  This 
field  is  used  by  the  lOADVANCE  statement. 

ZT15(8,N)  TOTAL  PENALTY  TIME 

This  field  contains  the  total  penalty  time  used 
by  this  device.  This  field  is  used  by  the  lOADVANCE 
statement . 
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AVAILABILITY  TABLE  -  T16 

PT16(1,N)  INPUT  -  OUTPUT  -  BOTH  DIRECTION  CODE 

This  entry  contains  a  cocic^  which  specifies  the 
direction  in  which  this  channel  -  control  unit  path 
may  be  used. 

1  =  INPUT  ONLY 

2  =  OUTPUT  ONLY 

3  =  INPUT  OR  OUTPUT 
PT16(2,N)  CHANNEL  ADDRESS 

This  entry  contains  the  address  of  the  channel 

in  the  channel  table  (T17)  which  ir  used  by  th5.s  avail¬ 
able  path.  If  this  field  is  positive  the  channel  is  a 
selector  channel  and  if  this  field  is  regati'fs  the  channel 
is  a  multiplexor  channel. 

PT16(3,N)  CONTROL  L^IT  AT’DUESS 

This  entry  contains  the  address  of  the  control 

unit  in  the  control  unit  table  (T16)  which  is  used  by 
this  available  path. 

PT16(4,N)  NOT  USED 
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CHANNEL  TABLE  -  T17 


CHANNEL  TABLE  ENTRY  I 

This  entry  is  used  for  selector  channels  or  the 
burst  mode  section  of  a  multiplexor  channel.  A  selector 
channel  has  only  one  entry  in  this  table  whereas  a  multi¬ 
plexor  channel  has  two  entries. 

IT17(1,N)  SEIZING  ID 

This  entry  contains  the  address  of  the  I/O  trans¬ 
action  item  currently  using  this  channel.  If  this  entry 
is  zero  the  channel  is  free.  If  this  is  a  multiplexor 
channel  this  entry  must  be  zero  if  the  channel  is  operat¬ 
ing  in  multiplex  mode,  and  the  current  multiplexor  rate 
must  be  zero  if  the  channel  is  operating  in  burst  mode. 

t 

IT17{2,N)  MAXI^TUM  CHANNEL  RATE 

This  entry  contains  the  maximum  transfer  rate  in 
characters  per  second  for  a  selector  channel  or  for  a 
multiplexor  channel  operating, in  burst  mode. 

IT17(3,N)  %  INTERFERENCE 

This  entry  contains  the  %  of  CPU  interference 

generated  by  this  chi'nnel.  This  value  is  in  %  per  iOOO 
CPS  transfer  rate. 
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IT17(4,N)  NOT  USED 
ZT17(3,N)  TOTAL  TIME  USED 

This  entry  contains  the  total  number  of  micro 
seconds  this  channel  was  active.  For  a  multiplexor  channel 
this  field  contains  the  time  this  channel  was  busy  in 
burst  mode. 

ZT17(4,N)  LOAD  IN  CHARACTERS  TRANSMITTED 

This  entry  contains  the  total  number  of 
characters  transmitted  over  this  channel.  For  a  multi¬ 
plexor  channel  this  is  the  total  number  of  characters 
transmitted  in  burst  mode. 
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CHANNEL  TABLE  ENTRY  II 

This  table  entry  is  used  for  the  multiplexor  mode 
of  a  multiplexor  channel. 

IT17(1,N)  CURRENT  MULTIPLEXOR  RATE 

This  field  contains  the  current  transfer  iate  on 
this  multiplexor  channel.  If  this  field  is  zero  the 
multiplexor  channel  is  not  being  used.  This  field  is 
added  to  by  an  lOADVANCE  statement  and  subtracted  from 
when  an  I/O  termination  occurs  for  this  channel. 

IT17(2,N)  MAXIMUM  MULTIPLEXOF  ''ATE 

This  field  contains  the  maximum  transfer  rate  in 
characters  per  second  for. a  multiplexor  channel  operating 
in  multiplexor  mode, 

IT17(3,N)  96  MULTIPLEXOR  INTERFERENCE 

This  entry  contains  the  96  of  CPU  interference 
generated  by  the  :nultiplexor  channel  operating  in 
multiplex  mode.  This  value  is  in  96  per  1000  characters 
per  second  transfer  rate. 

IT17(4,N)  NOT  USED 

2T17(3  N)  NOT  USED 

ZT17(4,N)  LOAD  IN  CHARACTERS  TRANSMITTED 

This  entry  contains  the  total  number  of  characters 

transmitted  over  this  channel  in  multiplexor  mode. 
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CONTROL  UNIT  TABLE  -  T18 


IT18(1,N)  SEIZING  ID 

fhe  address  of  the  lOTI  which  is  currently  using 
this  control  unit.  If  this  entry  is  zero  this  control 
unit  is  free. 

If  negative,  this  field  contains  the  #  ol  MPX 
operations  using  this  contrpl  unit. 

IT18(2,N)  NOT  USED 

ZT18(2,N)  TOTAL  CONTROL  UNIT  TIME 

This  entry  contains  the  total  amount  of  time  in 

micro  seconds  for  which  this  control  unit  has  been  busy. 
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DEVICE  CLASS  TABLE  -  T19 

IT19(i,N)  DEVICE  TYPE  CODE 

This  entry  contains  a  code  which  specifies  what 
type  of  device  this  entry  defines. 

1  =  UNIT  RECORD 

2  =  TAPE 

3  =  RANDOM  ACCESS 

4  =  OTHER 

AT19(2,N)  TRANSFER  RATE 

This  entry  contains  the  rate  at  which  this  device 

is  capable  of  accepting  data.  This  rate  is  given  in 

0 

characters  per  second. 

AT19(3,N)  TRANSFER  WIDTH  IN  BITS 

This  entry  contains  the  width  of  the  data  being 
transfered  in  bits. 

AT19(4,N)  START  &  STOP  TIME 

This  entry  gives  the  time  in  micro  seconds  needed 
to  start  and  stop  this  device.  This  time  is  added  to  the 
channel,  control  unit,  and  device  time  for  an  I/O  operation 
by  the  lOADVANCE  subroutines. 


AT19(5,N)  DEVICE  TIME 

This  entry  gives  the  time  in  micro  seconds  needed 
by  the  device  before  it  becomes  free  after  an  I/O  opera¬ 
tion  . 

AT19(6,N)  TIME  LIMIT  FOR  PENALTY 

This  entry  gives  the  time  in  micro  seconds  v*hich 

is  used  to  determine  if  a  penalty  time  should  be  added 

to  an  I/O  operation.  A  penalty  time,  if  any,  is  added  to 

an  I/O  operation  if  the  sum  of  the  time  when  the  last  I/O 

operation  completed  plus  the  time  limit*  for  a  penalty  is 

less  than  the  current  time.  This  test  is  made  by  the 

lOADVANCE  subroutine. 

AT19(7,N)  PENALTY  TIME 

This  field  contains  the  amount  of  time  in  micro 

seconds  to  be  added  to  device,  control,  and  channel  time 

if  a  penalty  as  described  above  is  incurred, 

AriO(8,N)  REWIND  TIME 

This  field  contains  the  amount  of  tine  in  micro 

« 

seconds  for  which  this  device  will  be  busy  if  a  CLOSE 
statement  which  specifies  REWIND  is  created.  This  field 
is  normally  used  only  for  tape  devices. 
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GENERAL  SIMULATION  TABLE  -  T20 


IT20(1)  CURRENT  CPU 

This  entry  contains  the  nunber  of  the  CPU  in  the 
simulation  model  which  is  currently  executing  instructions. 
This  field  is  altered  by  the  interrupt  handler  SllO. 

IT20(2)  CURRENT  PROGRAM  TYPE 

This  entry  contains  the  current  program  type, 

1  “  OS 

2  =  PRIMARY  WORKER 

3  =  COMMERCIAL  WORKER 

4  =  JIENTIFIC  WORKER 

IT20(3)  CURRENT  OP  CODE 

This  entry  contains  the  current  operation  code 
being  executed. 

IT20(4)  to  IT20(8)  OPERANDS 

This  entry  contains  the  operands  from  1  to  5 
associated  with  the  current  operation  code. 
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IT20(9)  SUBROUTINE  ERROR  CODE 

This  entry  contains  a  zero  until  some  subroutines 
detects  an  error  in  the  simulator.  When  a  sub  routine  de¬ 
tects  an  error,  the  error  number  and  th^  subroutines 
Ntu^er  are  picked  up  from  T20  and  printed.  Subroutine 
error  codes  below  100  terminate  the  simulation.  Sub¬ 
routine  error  codes  above  100  are  of  a  warning  nature 
and  do  not  terminate  the  simulator. 

IT20(10)  NSI  CODE 

This  entry  contains  the  number  of  statements  to 
be  skipped  by  SM2  before  executing  the  next  instruction. 

If  the  only  exit  line  from  a  subroutine  is  the  next 
sequential  instruction  this  field  is  left  zero.  If 
'the  next  instruction  is  to  be  skipped  this  field  is  set 
to  1  and  so  on. 

7T20(6)  CURRENT  SIMULATOR  TIME 

This  entry  contains  the  current  simulator  time 
as  a  double  pr«iv.lsion  number  accurate  to  18  decim.-l  places. 
This  value  is  kept  to  one  micro  seconds  precision  or  bettor. 
IT20(13)  SUBROUTINE  NUMBER 

This  entry  contains  the  subroutine  number  of  the 

current  subroutine  being  executed  by  SM2.  This  field  is 
set  by  the  first  instruction  in  each  subroutine. 


IT20(14)  FEC  CODE 


This  entry  contains  the  FEC  code  to  be  placbo 
on  the  future  events  chain  by  the  PUT  FEC  subroutine. 
IT20(15)  FEC  ITEM 

This  entry  contains  the  fee  item  to  be  placed 
on  the  future  events  chain  by  the  PUT  FEC  subroutine, 
IT20(16)  STORAGE  CONTIGUITY  CODE 

This  entry  contains  a  code  from  1  to  5  which 
specifies  the  manner  in  which  memory  is  to  be  allocated. 

1  ss  conti'^uous  Instruction  pages,  non-contiguous 

data  and  I/O. pages. 

2  =  non-contiguous  instruction  pages,  contiguous 

data  and  I/O  pages, 

3  *  contiguous  instruction  pages,  contiguous  but 

separate  data  and  l/c  pages. 

4  =  contiguous  instruction,  data,  and  I/O  pages, 

5s  non-contiguous  instruction,  data,  and  I/O  pages 
IT20(17)  MEMORY  OPERAND  -1 

This  entry  contains  the  first  operand  of  the 
last  MEMORY  statement  executed.  This  field  is  used  to 
insure  that  a  MEMORY  s'alcment  has  been  executed  before  an 


AtUXATE  statement. 


IT20(18)  MEMORY  OPERAND  -2 

This  entry  contains  the  second  operand  of  the 
last  MEMORY  statement  executed.  This  field  is  used  to 
insure  that  a  MEMORY  statement  has  been  executed  before 
an  ALLOCATE  statement. 

IT20(19)  LARGEST  CONTIGUOUS  STORAGE  AVAILABLE 

This  entry  contains  a  count  of  the  largest 
number  of  contiguous  pages  available  for  the  next 
ALLOCATE  statement.  It  is  set  by  the  MEMORY  statement 
and  reset  to  zero  by  the  ALLOCATE  statement. 

IT20(20)  LARGEST  CONTIGUOUS  STORAGE  REQUIRED 

This  entry  contains  a  count  of  the  largest 
number  of  contiguous  pages  required  by  the  last 
MEMORY  statement.  This  field  is  set  by  the  MEMORY 
subroutine  and  reset  by  the  ALLOCATE  subroutine, 

1X20(21)  SECOND  LARGEST  CONTIGUOUS  STORA'^S  AVAILABLE 

This  entry  contains  the  same  information  as 
1X20(19)  except  for  the  second  largest  contiguous  storage. 
IT20(22)  SECOND  LARGEST  CONTIGUOUS  STORAGE  REQUIRED 

This  entry  contains  the  same  information  at 
TT20(20)  except  for  the  second  largest  contiguous 
storage . 
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1X20(23)  NON  CONTIGUOUS  STORAGE  REQUIRED 


This  entry  contains  a  count  of  the  number  of 
pages  of  noncontiguous  memory  required  by  the  last 
memory  statement. 

IT20(24)  MEMORY  TI 

This  entry  contains  the  transaction  number  of 
the  last  transaction  for  which  a  MEMORY  subroutine  was 
executed.  This  field  is  used  to  insure  that  a  MEMORY 
statement  has  been  executed  for  a  transaction  before 
an  ALLOCATE  statement  is  executed.  The  ALLOCATE  sub¬ 
routine  resets  this  field  to  zero. 

IT20(25)  PACK  CODE 

This  entry  contains  a  zero  until  the  PACK  REQUIRED 
exit  line  of  a  MEMORY  statement  is  taken.  A  PACK  statement 
resets  this  field  to  zero.  An  ALLOCATE  subroutine  will 
issue  a  diagnostic  if  a  PACK  was  required  by  the  last 
MEMORY  test  but  was  net  performed. 

IT20(26)  INTERRUPT  CODE 

This  entry  contains  the  number  of  the  current 
interrupt  pending  (if  any)  this  field  is  used  by  the 
interrupt  handler  SllO  and  reset  to  zero. 
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2X20(14)  FEC  MANIPULATOR  TIME 

This  entry  contains  the  time  at  which  the  current 
item  being  placed  upon  the  future  events  chain  is  due 
to  come  off  the  chain. 

IT20(29)  FEC  POINTER 

This  entry  contains  a  pointer  to  the  slot  in  the 
future  events  chain  where  the  PUT  ITEM  subroutine  is  to 
place  the  FEC  CODE  (IT20{14))  and  the  FEC  ITEM  (IT20(15)) 
IT20(30)  PAGE  SIZE 

Tliis  entry  contains  the  page  size  in  bits  for  use 
by  SMI  when  determining  the  instruction,  data,  snd  I/O 
storage  required  for  each  transaction. 

IT20(32)  GENERATE  TI  WORKER  ROUTINE  NUMBER 

This  entry  contains  the  worker  routine  number 
from  1  to  99  for  which  a  transaction  item  is  to  be 
generated  when  calling  the  generate  transaction  item 
subroutine.  Upon  return  from  the  subroutine  this  entry 
contains  the  address  of  the  generated  transaction  item. 
IT20(33)  GENERATE  lOTI  TRANSACTION  NUMBER 

This  entry  contains  the  transaction  item  address 
from  1  to  N  for  which  an  I/O  transaction  item  Is  to  be 
generated  when  calling  the  generate  lOTI  subroutine. 
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Upon  return  from  this  subroutine  this  entry  contains 
the  address  of  the  generated  transaction  item. 

IT20(34)  STANDARD  PRIORITY 

This  entry  contains  the  standard  priority  as 
set  by  the  system  parameters  for  a  worker  routine  which 
enters  the  system  without  a  priority. 

ZT20(18)  STATISTICS  INTERVAL 

This  entry  gives  the  interval  in  micro  seconds 
between  statistics. 

ZT20(19)  NEXT  STATISTIC  TIME 

This  entry  contains  the  next  statistic  time 
expressed  in  micro  seconds, 

IT20(39)  TOTAL  NUMBER  OF  STATISTICS 

This  entry  contains  the  total  number  of  statis¬ 
tics  to  be  performed. 

IT20(40)  NUMBER  OF  STATISTICS  COMPLETED 

This  entry  contains  the  total  number  of  statis¬ 
tics  already  completed, 

IT20(41) 

IT20(42)  INTERFERENCE 

This  entry  contains  the  interference  rate  currently 


existing  in  the  system. 


ZT20(22)  INTERFERENCE  START  TIME 

This  entry  contains  the  time  expressed  in 
micro  seconds  at  which  the  interference  rate  last 
changed . 

ZT20(23)  INTERFERENCE  MICRO  SECONDS 

This  field  gives  the  total  percent  -  micro 
seconds  of  interference  accumulated  to  date. 

IT20(47)  QUEUE  LIMIT 

This  field  gives  the  limiting  entry  for  the 
queue  currently  being  examined.  If  the  queue  is 
being  examined  from  the  top  to  the  bottom  this  value 
is  equal  to  the  QUEUE-END  field  in  the  queue  table 
for  this  queue.  If  the  queue  is  being  examined  from 
the  bottom  to  the  top,  this  value  is  equal  to  the 
QUIIUE-START  field  in  the  queue  table  for  this  queue. 

IT20(48)  QUEUE  INCREMENT 

This  field  gives  the  increment  which  will  be 
added  to  the  QUEUE-POINTER  field  for  the  queue  being 
referenced  by  the  EXAMINE-NEXT  statement.  If  the 
queue  is  being  referenced  from  top  to  bottom,  this 
field  contains  a  +1.  If  the  queue  is  being  referenced 
from  bottom  to  top,  this  field  contains  a  -1. 


IT20(49)  RANDOM  NUMBER  USED 

This  field  contains  the  random  number  from 
1  to  99  as  generated  by  the  random  number  generator. 
IT20(50)  RANDOM  NUMBER  SEED 

This  field  contains  the  random  number  seed  as 
set  by  SMI. 

IT20(51)  INTERNAL  RANDOM  NUMBER 

This  field  is  initialized  to  equal  the  random 
number  seed  as  set  by  SMI.  Each  time  the  random  number 
generator  is  referenced  IT20{50)  =  IT20(49)  *  IT20(50). 
IT20(52)  NOT  USED 

ZT20(27)  AVAILABLE  SIMULATOR  TIME 

This  field  contains  the  amount  of  time  avail¬ 
able  in  all  CPU’s  by  this  simulator  for  statistics. 
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IT20(81)  to  1X20(100) 


DISTRIBUTION  TABLE 


These  fields  contain  the  values  to  be  used  for 


the  distribution  of 
ENTRY 
1 
2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 


compute  times  by  t] 
RANDOM  NUMBER 
0-4 
5-9 
10-14 
15-19 
20-24 
25-29 
30-34 
35-39 
40-44 
45-49 
50-54 
55-59 
60-64 
65-69 
70-74 

75-79 

• 

80-84  • 

85-89 
90-94 
95-99 


e  COMPUTE  subroutine. 
RANGE 


% 
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IT20(101)  0/S  PROGRAM  NUMBER  CPU  1 

This  entry  contains  the  number  of  thw  worker 
routines  to  be  used  as  an  operating  system  by  CPU  #2. 
1X20(102)  MEMORY  #  FOR  CPU  #1  0/S 

This  entry  contains  the  number  of  the  memory 
from  which  the  space  for  the  operating  system  for 
CPU  number  one  should  be  allocated. 

IT20(103)  to  IT20(110) 

These  entries  contain  the  same  information  for 
CPU's  2  through  5  as  the  two  entries  above. 


-65- 


myymwf'.’  'yMiw.  a-r*-ww,fjfr.»»CTfr5«fv.Mv-.^, 


IT20(121)  to  IT20(127)  STATISTIC  COUNTERS 

These  fields  contain  the  counter  for  each  of  the 
statistics  subroutines  STl  through  ST7.  If  any  of  these 
fields  are  set  negative  by  a  control  card,  the  correspon¬ 
ding  statistical  print  out  vd.ll  be  ignored. 

IT20(172)  SNAP  COUNTER 

This  entry  contains  a  counter  of  the  number  of 

times  the  snap  subroutines  has  been  called.  If  this,  field 
is  set  to  less  than  zero  by  control  card  the  snap  sub¬ 
routine  will  not  print. 

IT20(173)  TRACE  LINE  COUNTER 

This  entry  contains  a  line  counter  for  the 
trace  subroutine  which  allows  the  trace  subroutine  to 
skip  to  a  new  page  after  N  lines.  This  field  is  set 
to  exceed  the  page  limit  by  the  SNAP  subroutine. 

IT20(174)  TRACE  COUNTER 

This  entry  contains  a  counter  of  the  number 

of  times  the  trace  subroutines  has  been  called.  If 
this  field  has  been  set  to  less  than  zero  by  a  control 
card  the  trace  subroutine  will  not  pr^int, 

IT20(17.5)  to  IT20(200)  DUMP  SUBROUTINE  COUNTERS 

These  fields  provide  a  count  of  the  number  of 
times  each  dump  subroutine  was  called.  If  any  of  these 
fields  are  set  to  less  than  zero  by  the  dump  control 
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card  the  corresponding  DUMP  subroutine  is  not 
executed. 
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FUNCTION  TABLE  -  T21 

AT21  ( 1 ,  N  )  CHANNEL  TIME 

This  entry  specifies  the  amount  of  time  in 
micro  seconds  for  which  the  channel  is  to  be  con¬ 
sidered  busy  with  th^.::'  function  I/O. 

AT21(2,N)  CONTROL  TIME 

This  entry  specifies  the  aunount  of  time  in 
micro  seconds  for  which  the  control  unit  is  to  be  con¬ 
sidered  busy  with  this  function  I/O. 

AT21(3,N)  DEVICE  TIME 

This  entry  specifies  the  amount  of  time  in 
micro  seconds  for  which  this  device  is  to  be  con¬ 
sidered  busy  with  this  function  I/O. 

IT21(4,N)  DEVICE  NUMBER 

This  entry  specifies  the  device  number  for  which 
this  function  I/O  is  to  apply. 


STATEMENT  TABLE  T?2 


PT22(N) 

Each  entry  in  this  table  ;;ontains  an  operation 
code  or  an  operand  associated  with  an  operation  code 
which  will  control  the  execution  of  subroutines  in 
the  simulator. 
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SWITCH  TABLE  T23 


The  switch  table  contains  200  switches  which  can 
be  set  (turned»on)  or  reset  (turned  off).  For  each 
of  the  5  CPU's  there  are  20  local  switches. 


CPU 

#1 

SW 

1 

—  20 

CPU 

#2 

SW 

21 

-  40 

CPU 

SW 

41 

-  60 

CPU 

#4 

SW 

61 

-  80 

CPU 

#5 

SW 

81 

-  100 

Whic  are  referenced  as  SW  1  -  20.  Therefore,  it  is 
iiapossible  to  reference  any  switch  with  a  number  greater 
than  20  or  less  than  101. 

In  addition  there  are  100  switches  numbered  101  to 
200  which  are  global  across  all  CPU's, 

PT23(N) 

Each  entry  contains  a  -1  for  a  switch  which  is  off 
or  a  +1  for  a  switch  which  is  on.  All  switches  are 
initially  turned  off. 
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TO  -  FROM  T24 


AT24(N) 

Each  entry  in  this  table  contains  a  time  in 
microseconds  as  entered  from  the  system  parameters 
to  construct  a  TO  -  FROM  Table, 


MARK  TIME  TABLE  T25 


ZT25(N) 

Each  entry  in  this  table  contains  the  sum  of 
all  the  compute  times  executed  with  a  mark  #  equal 
to  N. 
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